.

NAME

ctys-extractARPlst - generates a list of mappings

SYNTAX

ctys-extractARPlst

   [-d <debug-args>]
   [-E]
   [-n|-i|-m]
   [-h]
   [-H <help-options>]
   [-p <db-dir-path>]
   [-P]
   [-q]
   [-V]
   [-X]
   <ping-hostlist-in-same-segment>

DESCRIPTION

ctys-extractARPlst (Address-Resolution) generates a sorted 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 uses a list of targets which has to be in the same segment as the executing machine. The list could contain any valid ctys <machine-address> or any <ctys-group> definition. The entities will be resolved and accessed as selected by options. The two methods are 'ping' which assures the basic TCP/IP-stack access, and 'arp' which lists the mapping as required. So the usage of this tool could be said providing 'real-in-time-data', without the limitation to static configured MAC-IP mapping, so recognizing pool-addresses too. But it's application is limited by the area of a single segment.

For additional segments the 'ctys-extractMAClst' tool should be used, which relies on configuration data for DHCP servers.

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

.

OPTIONS

ctys-extractARPlst

-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

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

-h

Print help, refer to "-H" for additional information.

-H <help-option>

The extended help option is based on system interfaces for display of manpages, PDF and HTML documents. This comprises the man pages and installed manuals.

For additional help refer to the documents or type ctys -H 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

<ping-hostlist-in-same-segment>

Any host within the same segment, will be ping-ed and arp-ed.

.

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-extractMAClst(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.