If you write an own system configuration tool do not list it in this man page, due to the fact that your change would be lost after an upgrade of WA2L/edrc. If you send your tool to the author of WA2L/edrc and it is decided to include it into the core distribution, your command will be added to this list.
If a man page is written for a system configuration tool, the manpage name convention is sysconfig.tools.my_command.3 and it has to be placed into the man page directory man/all/man3.
If a configuration supports multiple operating systems, what is normally the case in heterogeneous environments, you can place operating system dependent scripts into the directory var/sysconfig/tools/<OSID>, where <OSID> is the operating system id as returned by the osid(1) command, instead of coding everything directly into the check, pre_exec or post_exec script.
E.g.: if you like to set the default router entry on your Linux, HP-UX and Solaris systems (this is very different on those systems) in the post_exec script you can create a script called for instance 'set_default_router' for each operating system and place it into the related directory. This enables you to save effort in writing the post_exec script for all the operating systems to be configured and simplifies those scripts because you don't have to include the whole code into multiple post exec scripts.
If multiple operating systems can be handled identical, a
script can be placed into the
var/sysconfig/tools/default
folder and there is no need to have to place identical copies into more then
one
<OSID>
directory.
The search order is to first look for the tool script in the
operating system related directory (
<OSID>
) and then in the
default
directory. You should (of course) synchronize the tool directory contents
over all your WA2L/edrc installations to fully benefit from this feature. See
filedist(1)
for instructions how to distribute files easily.
tools-acme:*:901:7000:ACME Users Tools,Software,2008-05-31 2008-05-31,:/opt/SFI/tools-acme:/usr/bin/false tools-all:*:902:7000:all Users Tools,Software,2008-05-31 2008-05-31,:/opt/SFI/tools-all:/usr/bin/false ACME:*:904:7000:ACME Scripts,Software,2008-05-31 2008-05-31:/opt/ACME:/usr/bin/falseEOM
In addition to the standard network interface fields (INTERFACE_NAME, IP_ADDRESS, SUBNET_MASK, BROADCAST_ADDRESS, INTERFACE_MODULES, INTERFACE_STATE, DHCP_ENABLE) the field INTERFACE_DESCRIPTION is computed to define a textual description of the purpose for each interface.
In addition to the standard routing definition fields (ROUTE_DESTINATION, ROUTE_GATEWAY, ROUTE_COUNT, ROUTE_ARGS) the field ROUTE_DESCRIPTION is computed to define a textual description of the purpose for each route entry.
The result of the editing is sent to stdout to allow further data processing.
This is free software; see edrc/doc/COPYING for copying conditions. There is ABSOLUTELY NO WARRANTY; not even for MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.