• NAME
• USAGE
• DESCRIPTION
• COMMANDS
  • add-alias
  • add-dhcp
  • add-float
  • add-radius
  • add-static
  • add-virtual
  • change-comment
  • change-sector
  • change-host
  • change-ip
  • change-mac
  • change-tag
  • change-type
  • check-dns
  • create-sector
  • create-pool
  • create-pxe
  • create-tag
  • del-float
  • del-pc
  • disable-pc
  • disable-float
  • disable-pxe
  • enable-float
  • enable-pc
  • enable-pxe
  • gen-all-file
  • gen-dhcp-file
  • gen-dns-file
  • gen-radius-file
  • help
  • load-database
  • remove-pxe
  • remove-tag
  • search-mac
  • sector-add-ip
  • show-sector
  • show
  • show-pool
  • show-pxe
  • show-tag
  • version
• SEE ALSO
• AUTHORS
• LICENSE AND COPYRIGHT

NAME

ddt - management of computer names and IP addresses

USAGE

ddt add-alias [--hostname|-h hostname] [--sector|-s|-d sector] [--alias|-a alias]
ddt add-dhcp [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--comment|-c comment]
ddt add-float [--pool|-p pool] [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]
ddt add-radius [--hostname|-h hostname] [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]
ddt add-static [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--comment|-c comment]
ddt add-virtual [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--comment|-c comment]
ddt change-comment [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]
ddt change-sector [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]
ddt change-host [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]
ddt change-ip [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]
ddt change-mac [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]
ddt change-tag [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--tag|-t tag]
ddt change-type [--hostname|-h hostname] [--sector|-s|-d sector] [--type|-t type]
ddt check-dns [--direct|-d] [--reverse|-r] [--by-ip|-b] [--clean-cache|-c]
ddt create-sector [--sector|-s|-d sector] [--dns-extension|-e dns_extension] [--comment|-c comment]
ddt create-pool [--pool|-p pool] [--sector|-s|-d sector] [--file-pool|-f file_pool] [--ipaddress-pool|-i ipaddress_pool]
ddt create-pxe [--bootp|-b pxe_config] [--next-server|-n next_server] [--filename|-f filename] [--comment|-c comment]
ddt create-tag [--tag|-t tag] [--comment|-c comment]
ddt del-float [--pool|-p pool] [--mac|-m mac]
ddt del-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]
ddt disable-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]
ddt disable-float [--pool|-p pool] [--mac|-m mac]
ddt disable-pxe [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]
ddt enable-float [--pool|-p pool] [--mac|-m mac]
ddt enable-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]
ddt enable-pxe [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--bootp|-b pxe_config]
ddt gen-all-file
ddt gen-dhcp-file
ddt gen-dns-file [--verbose]
ddt gen-radius-file
ddt help
ddt load-database [--sector|-s|-d sector] [--filename|-f filename] [--kind|-k kind]
ddt remove-pxe [--bootp|-b pxe_config]
ddt remove-tag [--tag|-t tag]
ddt search-mac [--mac|-m mac]
ddt sector-add-ip [--sector|-s|-d sector] [--ip-range|-i ip_cidr] 
ddt show-sector [--no-header|-H]
ddt show
ddt show-pool [--no-header|-H]
ddt show-pxe [--no-header|-H]
ddt show-tag [--no-header|-H]
ddt version

DESCRIPTION

DDT is an acronym for DHCP-DNS-Tools. The previous command name was not ddt but just dhcp-dns-tools... In practise, DDT is an IP Address Management (IPAM) service. It has been used in the LEGI laboratory for over 10 years.

The tool is quite effective and tries to keep things simple but easily configurable for your site like a swiss army knife. Everything is saved in a YAML database and entries could be added, deleted, or modified by the command line.

COMMANDS

add-alias

ddt add-alias [--hostname|-h hostname] [--sector|-s|-d sector] [--alias|-a alias]

add-dhcp

ddt add-dhcp [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--comment|-c comment]

add-float

ddt add-float [--pool|-p pool] [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]

add-radius

ddt add-radius [--hostname|-h hostname] [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]

add-static

Add a static host in the database. No DHCP configuration will be generated, only DNS.

ddt add-static [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--comment|-c comment]

add-virtual

Add a static host in the database with a virtual MAC address beginning by FF:FF:.... No DHCP configuration will be generated, only DNS.

ddt add-virtual [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--comment|-c comment]

change-comment

ddt change-comment [--sector|-s|-d sector] [--mac|-m mac] [--comment|-c comment]

change-sector

ddt change-sector [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]

change-host

ddt change-host [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]

change-ip

ddt change-ip [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]

change-mac

ddt change-mac [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac]

change-tag

This command is used to modify tags on a computer. If you wish to add a tag, you must write both the old and the new tag on the command line, otherwise the old tag is lost. Tags must be separated by commas.

ddt change-tag [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--mac|-m mac] [--tag|-t tag]

If you wish to delete all tags on a computer, simply assign the universal tag to it.

change-type

ddt change-type [--hostname|-h hostname] [--sector|-s|-d sector] [--type|-t type]

check-dns

ddt check-dns [--direct|-d] [--reverse|-r] [--by-ip|-b] [--clean-cache|-c]

Only check reverse with --reverse and direct with --direct, otherwise, check the two. Clean nscd host cache with option --clean-cache.

Option --by-ip will check every IP in the DNS that is not declare un ddt.

create-sector

ddt create-sector [--sector|-s|-d sector] [--dns-extension|-e dns_extension] [--comment|-c comment]

create-pool

ddt create-pool [--pool|-p pool] [--sector|-s|-d sector] [--file-pool|-f file_pool] [--ipaddress-pool|-i ipaddress_pool]

create-pxe

ddt create-pxe [--bootp|-b pxe_config] [--next-server|-n next_server] [--filename|-f filename] [--comment|-c comment]

create-tag

This command is used to define a tag for subsequent use on computers. Note that the default tag is universal. Machines with no tag have this tag.

ddt create-tag [--tag|-t tag] [--comment|-c comment]

del-float

ddt del-float [--pool|-p pool] [--mac|-m mac]

del-pc

ddt del-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]

disable-pc

ddt disable-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]

disable-float

ddt disable-float [--pool|-p pool] [--mac|-m mac]

disable-pxe

ddt disable-pxe [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]

enable-float

ddt enable-float [--pool|-p pool] [--mac|-m mac]

enable-pc

ddt enable-pc [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip]

enable-pxe

ddt enable-pxe [--hostname|-h hostname] [--sector|-s|-d sector] [--ip|-i ip] [--bootp|-b pxe_config]

gen-all-file

ddt gen-all-file

gen-dhcp-file

ddt gen-dhcp-file

gen-dns-file

ddt gen-dns-file [--verbose]

gen-radius-file

ddt gen-radius-file

help

ddt help

load-database

ddt load-database [--sector|-s|-d sector] [--filename|-f filename] [--kind|-k kind]

remove-pxe

ddt remove-pxe [--bootp|-b pxe_config]

remove-tag

This command removes a tag from the list of possible tags to be applied to a machine park. Note that no machine must have the tag before it can be deleted. The universal tag cannot be deleted.

ddt remove-tag [--tag|-t tag]

search-mac

ddt search-mac [--mac|-m mac]

sector-add-ip

ddt sector-add-ip [--sector|-s|-d sector] [--ip-range|-i ip_cidr] 

show-sector

ddt show-sector [--no-header|-H]

show

ddt show

show-pool

ddt show-pool [--no-header|-H]

show-pxe

ddt show-pxe [--no-header|-H]

show-tag

This command lists all the tags that can be assigned to a computer via the change-tag command.

ddt show-tag [--no-header|-H]

The tag with the name universal exists intrinsically. It cannot be destroyed. It's useful if you don't declare a tag for a machine.

version

ddt version

SEE ALSO

Own project ressources:

• Web site (Gitlab)

• Online Manual

• Download package (Debian)

Note: The master Git repository in on the GRICAD Gitlab. Other Git repository are mirror or fork.

AUTHORS

Written by Gabriel Moreau <Gabriel.Moreau(A)univ-grenoble-alpes.fr>, Kevin Reverchon, Olivier De-Marchi - Grenoble - France

LICENSE AND COPYRIGHT

License GNU GPL version 2 or later and Perl equivalent

Copyright (C) 2006-2024, LEGI UMR 5519 / CNRS UGA G-INP, Grenoble, France