admbootpclient(1M) TCP/IP 5.4R3.00 admbootpclient(1M)
NAME
admbootpclient - manage the BOOTP server
SYNOPSIS
admbootpclient -o add [-H homedirectory] [-B bootfile]
[-b bootserver] [-C cookieservers]
[-D domainnameservers] [-G gateways] [-T hardwaretype]
[-A hardwareaddress] [-i impressservers]
[-I hostIPaddress] [-l logservers] [-L LPRservers]
[-E IENnameservers] [-R resourcelocationprotoservers]
[-M subnetmask] [-c templatehost] [-t timeoffset]
[-S timeservers] [-h] clientname
admbootpclient -o delete clientname
admbootpclient -o modify [-H homedirectory] [-B bootfile]
[-b bootserver] [-C cookieservers]
[-D domainnameservers] [-G gateways] [-T hardwaretype]
[-A hardwareaddress] [-i impressservers]
[-I hostIPaddress] [-l logservers] [-L LPRservers]
[-E IENnameservers] [-R resourcelocationprotoservers]
[-M subnetmask] [-c templatehost] [-t timeoffset]
[-S timeservers] [-V vendorreplytype] [-h] clientname
admbootpclient -o list [ -qv ] all | clientname [...]
DESCRIPTION
Admbootpclient manages the BOOTP server (daemon) configuration file.
This file contains information that is used by bootpd to allow
diskless client machines to discover information about themselves.
The diskless client will broadcast a BOOTP Request on the network,
and if a bootpd server knows about that client it will respond with
the information found in the configuration file.
Operations
add Adds an entry in the /etc/bootptab file.
delete Removes an entry in the /etc/bootptab file.
modify Modifies an entry in the /etc/bootptab file.
list Writes the contents of the /etc/bootptab file to standard
output.
Common Options
-H homedirectory
is the home directory for clientname. This should be the
directory where the second-stage bootstrap is located.
-B bootfile
is the name of the second-stage bootstrap that clientname
uses if the client does not supply a filename in the
request.
Licensed material--property of copyright holder(s) 1
admbootpclient(1M) TCP/IP 5.4R3.00 admbootpclient(1M)
-b bootserver
is the IP address of the server that holds the second-stage
bootstrap. The clientname should use this server when
downloading the file. If bootserver is specified, then no
file existence check will occur when replying to
clientname.
-G gateways
define the IP addresses of the gateways that clientname has
available.
-T hardwaretype
defines the hardware type that clientname has. This allows
for the correct interpretation of the hardware address.
Hardware types are ethernet, ethernet3, ieee802, pronet,
chaos, arcnet, and ax.25.
-A hardwareaddress
defines the hardware address of clientname. This field is
used as the key for finding information about clientname.
-I hostIPaddress
defines the IP address of clientname.
-M subnetmask
defines the subnet mask for clientname. The mask is in the
form of a dotted-quad IP address.
-c templatehost
defines a clientname that clientname should use for default
values.
The template host (tc tag) is provided so that the
system administrator can setup one or more entries in the
/etc/bootptab file that contain defaults for their system.
Items that would probably be included in these entries
would be gateway, subnet mask, time offset, time server,
etc. Once these entries are setup, the system
administrator only needs to setup specific information for
a client (e.g. IP Address and hardware address) and include
the appropriate template host for the remainder of the
information.
It is assumed that the system administrator knows what
each of the templates defines. When the system
administrator specifies a template host, they will not see
a change in the sysadm menus showing the fields and values
that are defined in the template host. The values in the
template host will be applied to the client when bootpd is
started and the /etc/bootptab is read in.
Other Options
-C cookieservers
define the IP addresses of cookie servers on the network.
Licensed material--property of copyright holder(s) 2
admbootpclient(1M) TCP/IP 5.4R3.00 admbootpclient(1M)
These servers can provide keys for encryption or licensing.
-D domainnameservers
define the IP addresses of the network name servers.
-i impressservers
define the IP addresses of the impress servers.
-l logservers
define the IP addresses of the log servers clientname can
use.
-L LPRservers
define the IP addresses of the LPR servers clientname can
use.
-E IEN-116servers
define the IP addresses of the IEN-116 names servers for
clientname.
-R resourcelocationprototypeservers
define the IP addresses for clientname.
-t timeoffset
defines the number of seconds clientname is from GMT.
-S timeservers
define the IP addresses that clientname can use to
synchronize its time.
-V vendorreplytype
defines the format of the bootp response packet. This
information should be found in the documentation that came
with the client machine. 'rfc1048' refers to the BOOTP
Reply that is defined in RFC-1048. 'cmu' refers to a
specialized BOOTP Reply that Carnegie-Mellon University
uses. 'auto' indicates that the type of reply will be
based on the clients request.
-h indicates that the clientname should be returned in the
reply.
-v lists the specified clients in aligned columns with column
headers.
-q lists the specified clients, unformatted.
EXAMPLES
In the following examples, the system administrator performs the
following actions: adds the host bar, to be used as a template host;
adds the host foo; deletes the host foo.
admbootpclient -o add -G "130.3.8.2 130.3.8.3" -T ether -M 255.255.255.0 bar
admbootpclient -o add -c bar -I 130.3.8.25 -A 1b:00:2c:9c:70:0f foo
Licensed material--property of copyright holder(s) 3
admbootpclient(1M) TCP/IP 5.4R3.00 admbootpclient(1M)
admbootpclient -o delete foo
FILES
/etc/bootptab File that contains the BOOTP server database.
DIAGNOSTICS
Warnings
- The delete operation is requested, and clientname does not exist.
Errors
- The add operation is requested, and clientname already exists.
Exit Codes
0 The operation was successful.
1 The operation was unsuccessful.
2 The operation failed due to access restrictions.
3 There was an error in the command line.
SEE ALSO
bootpd(1M).
NOTES
All IP addresses are in the dotted-quad format (eg. 130.30.8.25).
Multiple IP addresses must be enclosed in quotation marks with each
IP address separated by a space.
Licensed material--property of copyright holder(s) 4