.

NAME

ctys-extractMAClst - generates a list of mappings DHCP

SYNTAX

ctys-extractMAClst

   [-d <debug-args>]
   [-E]
   [-n|-i|-m]
   [-h]
   [-H <help-options>]
   [-p <db-dir-path>]
   [-P]
   [-q]
   [-V]
   [-X]
   <pathname-of-dhcpd.conf>

DESCRIPTION

ctys-extractMAClst (Address-Resolution) generates a list of 3-column table containing:

• <nodename>;<IP-Address>;<MAC-Address>

Alternatively output to stdout could be generated for usage in "/etc/ethers".

• <MAC-Address> <nodename>

or

• <MAC-Address> <IP-Address>

Therefore this tool requires as source a valid "dhcpd.conf"-Syntax as defined by ISC.

Static configured address mappings are supported only. Dynamic allocated leases of address ranges are not supported.

ctys-tools generally expect for input generated files with default column-order, which is defined by "-n".

.

OPTIONS

ctys-extractMAClst

-d <debug-args>

Refer to "ctys" generic options for additional information.

-E

Generates output for "/etc/ethers". This is required when using ether-wake for WoL, what is no longer supported by ctys.

The options "-n" and "-i" become in combination with "-E" a slightly different semantic:

• -n output is "<MAC-addr> <DNS name>"
• -i output is "<MAC-addr> <dotted IP address>"
  The option is not supported with "-E".
  
  

-n|-i|-m

Default output is "-n".

-n Print sorted records: <name>;<MAC>;<IP>

-i Print sorted records: <IP>;<name>;<MAC>

-m Print sorted records: <MAC>;<name>;<IP>

-h

Print help.

-p <db-dir-path>

Directory for data to be stored. This is - and has to be in this version - the same directory as used by ctys-vdbgen and ctys-vhost.

So each file-based ctys-DB requires it's own mapping file for now. This is going to be extended when the LDAP based addressing is introduced. Anyhow, this feature will remain, because it has some advantages for daily business when setting up small to medium networks or multiple test-environments.

The hard-coded filename is "macmap.cfdb"

-P

Almost same as "-p", but takes default ctys-file-DB, provided by DEFAULT_DBPATHLST.

Default output is stdout.

-V

Version.

-X

Terse output format, effects "-V" when set left-of.

.

ARGUMENTS

<dhcp.conf-filename>

This tool requires a valid "dhcpd.conf"-Syntax.

.

EXIT-VALUES

0: OK:

Result is valid.

1: NOK:

Erroneous parameters.

2: NOK:

Missing an environment element like files or databases.

SEE ALSO

ctys executables

ctys-extractARPlst(1), ctys-vping(1), ctys-vhost(1)

AUTHOR

Written and maintained by Arno-Can Uestuensoez:

COPYRIGHT

Copyright (C) 2008, 2009, 2010 Ingenieurbuero Arno-Can Uestuensoez

For BASE package following licenses apply,

• for software see GPL3 for license conditions,
• for documents see GFDL-1.3 with invariant sections for license conditions,

This document is part of the DOC package,

• for documents and contents from DOC package see
  'Creative-Common-Licence-3.0 - Attrib: Non-Commercial, Non-Deriv'
  
  
  with optional extensions for license conditions.

For additional information refer to enclosed Releasenotes and License files.