.

NAME

ctys-macmap - searches within the given list of "macmap.fdb"

SYNTAX

ctys-macmap

   [-d <debug-options>]
   [-n|-i|-m]
   [-h]
   [-H <help-options>]
   [-p <db-dir-path-list>]
   [-u]
   [-V]
   [-X]
   <simple awk-regexpr>

DESCRIPTION

ctys-macmap (Address-Resolution) searches within the given list of 'macmap.fdb' for matching lines, and shows the requested fields of result. Simple awk-regexpr as for 'ctys-vhost' are supported. The result is pre-sorted, though in case of multiple results these will be presented sorted.

The contents of 'macmap.fdb' are displayed as one record on each line with the following fields.

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

For the generation of macmap.fdb from standard dhcp.conf and the limitation to static assignment data refer to 'ctys-extractMAClst'.

.

OPTIONS

ctys-macmap

-d <debug-args>

Refer to "ctys" generic options for additional information.

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

-n|-i|-m

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

-p <db-dir-path-list>

Two syntaxes are supported for <db-dir-path-list>:

- PATH-like with FS=':':

<db-dir-path-list>=<db-dir-path>[:<db-dir-path>[:...]]

• ctys-conformant with FS='%', due to leveled scanner-hierarchies:
  <db-dir-path-list>=<db-dir-path>[%<db-dir-path>[%...]]
  Both supported field separators are reserved values. Directory paths for databases, containing a file with hard-coded name "macmap.fdb".
  When missing, the default DEFAULT_DBPATHLST will be used.
  ATTENTION: Currently no spaces are supported within pathnames!

-u

The output is displayed in uppercase only.

-V

Version.

-X

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

.

ARGUMENTS

A "simple" regexpr for awk, used as in given extract:

  awk -v s="\${argLst}" 
    '\$0~s\&\&n==1  '{cache=cache \$1;  mx=1;} ...'

Therefore e.g.

  ctys-macmap  -n -m '00:50:56:.3:..:.9'

generates the following matches:

  tst009;00:50:56:13:11:39
  tst108;00:50:56:13:11:49

The comparison of MAC addresses is non-casesensitive, where the internal storage format is in uppercase. It should be avoided to edit the database manually, but when required the MAC addresses has to be stored with uppercase characters [A-F].

.

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-extractMAClst(1), ctys-genmconf(1), ctys-plugins(1), ctys-vping(1), ctys-vhost(1), ctys-wakeup(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.