diff options
author | Bart Coddens <bart.coddens@gmail.com> | 2014-11-04 14:39:24 -0500 |
---|---|---|
committer | Dan McDonald <danmcd@omniti.com> | 2014-11-04 15:33:26 -0500 |
commit | 786d1eec1cd1cac7e26243d118cd209e84bc6bb9 (patch) | |
tree | 683376f31035f4287d883ea67803af67b99183b1 /usr/src/man/man1m | |
parent | f07f0fb66492a2792d4da5e0a6f9a92b4c581ab3 (diff) | |
download | illumos-joyent-786d1eec1cd1cac7e26243d118cd209e84bc6bb9.tar.gz |
4174 Torch the old and unmaintained Sun-dhcp
Reviewed by: Josef Sipek <jeffpc@josefsipek.net>
Reviewed by: Garrett D'Amore <garrett@damore.org>
Approved by: Dan McDonald <danmcd@omniti.com>
Diffstat (limited to 'usr/src/man/man1m')
-rw-r--r-- | usr/src/man/man1m/Makefile | 6 | ||||
-rw-r--r-- | usr/src/man/man1m/dhcpconfig.1m | 792 | ||||
-rw-r--r-- | usr/src/man/man1m/dhcpmgr.1m | 164 | ||||
-rw-r--r-- | usr/src/man/man1m/dhtadm.1m | 658 | ||||
-rw-r--r-- | usr/src/man/man1m/dsvclockd.1m | 82 | ||||
-rw-r--r-- | usr/src/man/man1m/in.dhcpd.1m | 496 | ||||
-rw-r--r-- | usr/src/man/man1m/pntadm.1m | 737 |
7 files changed, 0 insertions, 2935 deletions
diff --git a/usr/src/man/man1m/Makefile b/usr/src/man/man1m/Makefile index 2112b279e9..133bd112f1 100644 --- a/usr/src/man/man1m/Makefile +++ b/usr/src/man/man1m/Makefile @@ -104,9 +104,6 @@ _MANFILES= 6to4relay.1m \ dfshares.1m \ dfshares_nfs.1m \ dhcpagent.1m \ - dhcpconfig.1m \ - dhcpmgr.1m \ - dhtadm.1m \ disks.1m \ diskscan.1m \ dispadmin.1m \ @@ -122,7 +119,6 @@ _MANFILES= 6to4relay.1m \ dscfgadm.1m \ dscfglockd.1m \ dsstat.1m \ - dsvclockd.1m \ dtrace.1m \ dumpadm.1m \ editmap.1m \ @@ -196,7 +192,6 @@ _MANFILES= 6to4relay.1m \ in.chargend.1m \ in.comsat.1m \ in.daytimed.1m \ - in.dhcpd.1m \ in.discardd.1m \ in.echod.1m \ in.fingerd.1m \ @@ -377,7 +372,6 @@ _MANFILES= 6to4relay.1m \ plockstat.1m \ pmadm.1m \ pmconfig.1m \ - pntadm.1m \ polkit-is-privileged.1m \ pooladm.1m \ poolbind.1m \ diff --git a/usr/src/man/man1m/dhcpconfig.1m b/usr/src/man/man1m/dhcpconfig.1m deleted file mode 100644 index ccb4eb6bed..0000000000 --- a/usr/src/man/man1m/dhcpconfig.1m +++ /dev/null @@ -1,792 +0,0 @@ -'\" te -.\" Copyright (c) 2002 by Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DHCPCONFIG 1M "Jun 16, 2004" -.SH NAME -dhcpconfig \- DHCP service configuration utility -.SH SYNOPSIS -.LP -.nf -\fBdhcpconfig\fR \fB-D\fR \fB-r\fR \fIresource\fR \fB-p\fR \fIpath\fR [\fB-u\fR \fIuninterpreted\fR] - [\fB-l\fR \fIlease_length\fR] [\fB-n\fR ] [\fB-d\fR \fIDNS_domain\fR] - [\fB-a\fR \fIDNS_server_addresses\fR] [\fB-h\fR \fIhosts_resource\fR] - [\fB-y\fR \fIhosts_domain\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-R\fR \fIserver_addresses\fR -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-U\fR [\fB-f\fR] [\fB-x\fR] [\fB-h\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-N\fR \fInetwork_address\fR [\fB-m\fR \fIsubnet_mask\fR] [\fB-b\fR ] - [\fB-t\fR \fIrouter_addresses\fR] [\fB-y\fR \fINIS-domain\fR] - [\fB-a\fR \fINIS_server_addresses\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-C\fR \fB-r\fR \fIresource\fR \fB-p\fR \fIpath\fR [\fB-f\fR] [\fB-k\fR] - [\fB-u\fR \fIuninterpreted\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-X\fR \fIfilename\fR [\fB-m\fR \fImacro_list\fR] [\fB-o\fR \fIoption_list\fR] - [\fB-a\fR \fInetwork_addresses\fR] [\fB-f\fR] [\fB-x\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-I\fR \fIfilename\fR [\fB-f\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-P\fR [\fIparameter\fR[=\fIvalue\fR],]... -.fi - -.LP -.nf -\fBdhcpconfig\fR \fB-S\fR [\fB-f\fR] [\fB-e\fR | \fB-d\fR | \fB-r\fR | \fB-q\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdhcpconfig\fR command is used to configure and manage the Dynamic Host -Configuration Protocol (DHCP) service or BOOTP relay services. It is intended -for use by experienced Solaris system administrators and is designed for ease -of use in scripts. The \fBdhcpmgr\fR utility is recommended for less -experienced administrators or those preferring a graphical utility to configure -and manage the DHCP service or BOOTP relay service. -.sp -.LP -The \fBdhcpconfig\fR command can be run by root, or by other users assigned to -the DHCP Management profile. See \fBrbac\fR(5) and \fBuser_attr\fR(4). -.sp -.LP -\fBdhcpconfig\fR requires one of the following function flags: \fB-D\fR, -\fB-R\fR, \fB-U\fR, \fB-N\fR, \fB-C\fR, \fB-X\fR, \fB-I\fR, \fB-P\fR or -\fB-S\fR. -.sp -.LP -The \fBdhcpconfig\fR menu driven mode is supported in Solaris 8 and previous -versions of Solaris. -.SS "Where dhcpconfig Obtains Configuration Information" -.sp -.LP -\fBdhcpconfig\fR scans various configuration files on your Solaris machine for -information it can use to assign values to options contained in macros it adds -to the \fBdhcptab\fR configuration table. The following table lists information -\fBdhcpconfig\fR needs, the source used, and how the information is used: -.sp - -.sp -.TS -box; -l | l | l -l | l | l . -\fIInformation\fR \fISource\fR \fIWhere Used\fR -_ -Timezone System date, timezone settings \fBLocale\fR macro -DNS parameters \fBnsswitch.conf\fR, \fB/etc/resolv.conf\fR Server macro -NIS parameters System domainname, \fBnsswitch.conf\fR, NIS Network macros -Subnetmask T{ -Network interface, \fBnetmasks\fR table in nameservice -T} Network macros -.TE - -.sp -.LP -If you have not set these parameters on your server machine, you should do so -before configuring the DHCP server with \fBdhcpconfig\fR. Note that if you -specify options with the \fBdhcpconfig \fR\fB-D\fR command line, the values you -supply override the values obtained from the system files. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-C\fR\fR -.ad -.RS 23n -Convert to using a new data store, recreating the DHCP data tables in a format -appropriate to the new data store, and setting up the DHCP server to use the -new data store. -.sp -The following sub-options are required: -.sp -.ne 2 -.na -\fB\fB-p\fR \fIpath_to_data\fR\fR -.ad -.RS 20n -The paths for \fBSUNWfiles\fR and \fBSUNWbinfiles\fR must be absolute -\fBUNIX\fR pathnames. The path for \fBSUNWnisplus\fR must be a fully specified -\fBNIS+\fR directory (including the tailing period.) See \fBdhcp_modules\fR(5). -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR \fIdata_resource\fR\fR -.ad -.RS 20n -New data store resource. One of the following must be specified: -\fBSUNWfiles\fR, \fBSUNWbinfiles\fR, or \fBSUNWnisplus\fR. See -\fBdhcp_modules\fR(5). -.RE - -The following sub-options are optional: -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.RS 20n -Do not prompt for confirmation. If \fB-f\fR is not used, a warning and -confirmation prompt are issued before the conversion starts. -.RE - -.sp -.ne 2 -.na -\fB\fB-k\fR\fR -.ad -.RS 20n -Keep the old DHCP data tables after successful conversion. If any problem -occurs during conversion, tables are not deleted even if \fB-k\fR sub-option is -not specified. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR \fIuninterpreted\fR\fR -.ad -.RS 20n -Data which is ignored by \fBdhcpconfig\fR, but passed on to the datastore for -interpretation. The private layer provides for module-specific configuration -information through the use of the \fBRESOURCE_CONFIG \fR keyword. -Uninterpreted data is stored within \fBRESOURCE_CONFIG\fR keyword of -\fBdhcpsvc.conf\fR(4). The \fB-u\fR sub-option is not used with the -\fBSUNWfiles\fR, \fBSUNWbinfiles\fR, and \fBSUNWnisplus\fR data stores. See -\fBdhcp_modules\fR(5). -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR\fR -.ad -.RS 23n -Configure the \fBDHCP\fR service. -.sp -The following sub-options are required: -.sp -.ne 2 -.na -\fB\fB-r\fR \fIdata_resource\fR\fR -.ad -.RS 20n -One of the following must be specified: \fBSUNWfiles\fR, \fBSUNWbinfiles\fR, or -\fBSUNWnisplus\fR. Other data stores may be available.See -\fBdhcp_modules\fR(5). -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR \fIpath\fR\fR -.ad -.RS 20n -The paths for \fBSUNWfiles\fR and \fBSUNWbinfiles\fR must be absolute -\fBUNIX\fR pathnames. The path for \fBSUNWnisplus\fR must be a fully specified -\fBNIS+\fR directory (including the tailing period.) . See -\fBdhcp_modules\fR(5). -.RE - -The following sub-options are optional: -.sp -.ne 2 -.na -\fB\fB-a\fR \fIDNS_servers\fR\fR -.ad -.RS 21n -IP addresses of DNS servers, separated with commas. -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR \fIDNS_domain\fR\fR -.ad -.RS 21n -DNS domain name. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR \fIhosts_resource\fR\fR -.ad -.RS 21n -Resource in which to place hosts data. Usually, the name service in use on the -server. Valid values are \fBnisplus\fR, \fBfiles\fR, or \fBdns\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR \fIseconds\fR\fR -.ad -.RS 21n -Lease length used for addresses not having a specified lease length, in -seconds. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.RS 21n -Non-negotiable leases -.RE - -.sp -.ne 2 -.na -\fB\fB-y\fR \fIhosts_domain\fR\fR -.ad -.RS 21n -DNS or NIS+ domain name to be used for hosts data. Valid only if \fBdns\fR or -\fBnisplus\fR is specified for \fB-h\fR sub-option. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR \fIuninterpreted\fR\fR -.ad -.RS 21n -Data which is ignored by \fBdhcpconfig\fR, but passed on to the datastore for -interpretation. The private layer provides for module-specific configuration -information through the use of the \fBRESOURCE_CONFIG \fR keyword. -Uninterpreted data is stored within \fBRESOURCE_CONFIG\fR keyword of -\fBdhcpsvc.conf\fR(4). The \fB-u\fR sub-option is not used with the -\fBSUNWfiles\fR, \fBSUNWbinfiles\fR, and \fBSUNWnisplus\fR data stores. See -\fBdhcp_modules\fR(5). -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-I\fR \fIfilename\fR\fR -.ad -.RS 23n -Import data from \fIfilename\fR, containing data previously exported from a -Solaris DHCP server. Note that after importing, you may have to edit macros to -specify the correct domain names, and edit network tables to change the owning -server of addresses in imported networks. Use \fBdhtadm\fR and \fBpntadm\fR to -do this. -.sp -The following sub-options are supported: -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.RS 6n -Replace any conflicting data with the data being imported. -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR\fR -.ad -.RS 6n -Signal the daemon to reload the \fBdhcptab\fR once the import has been -completed. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-N\fR \fInet_address\fR\fR -.ad -.RS 23n -Configure an additional network for DHCP service. -.sp -The following sub-options are supported: -.sp -.ne 2 -.na -\fB\fB-a\fR \fINIS_server_addresses\fR\fR -.ad -.RS 27n -List of IP addresses of NIS servers. -.RE - -.sp -.ne 2 -.na -\fB\fB-b\fR\fR -.ad -.RS 27n -Network is a point-to-point (PPP) network, therefore no broadcast address -should be configured. If \fB-\fRb is not used, the network is assumed to be a -LAN, and the broadcast address is determined using the network address and -subnet mask. -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR\fR -.ad -.RS 27n -Signal the daemon to reload the \fBdhcptab\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR \fIxxx.xxx.xxx.xxx\fR\fR -.ad -.RS 27n -Subnet mask for the network; if \fB-m\fR is not used, subnet mask is obtained -from netmasks. -.RE - -.sp -.ne 2 -.na -\fB\fB-t\fR \fIrouter_addresses\fR\fR -.ad -.RS 27n -List of router IP addresses; if not specified, router discovery flag is set. -.RE - -.sp -.ne 2 -.na -\fB\fB-y\fR \fINIS_domain_name\fR\fR -.ad -.RS 27n -If NIS is used on this network, specify the NIS domain name. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR\fR -.ad -.RS 23n -Configure the DHCP service parameters. Each parameter and value are specified -by the following pattern: -.sp -.in +2 -.nf -\fIparameter\fR[=\fIvalue\fR],\&.\|.\|. -.fi -.in -2 -.sp - -Where parameter and value are: -.sp -.ne 2 -.na -\fB\fIparameter\fR\fR -.ad -.RS 13n -One of the DHCP service parameters listed in \fBdhcpsvc.conf\fR(4). If the -corresponding \fIvalue\fR is not specified, the current parameter value is -displayed. If \fIparameter\fR is not specified, all parameters and current -values are displayed. -.RE - -.sp -.ne 2 -.na -\fB\fIvalue\fR\fR -.ad -.RS 13n -Optional string to set the servers parameter to if the value is acceptable. If -the value is missing or is empty (\fB""\fR), the parameter and its current -value are deleted. -.RE - -After a parameter has changed the DHCP server requires re-starting before you -can use new parameter values. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fIserver_addresses\fR\fR -.ad -.RS 23n -Configure the BOOTP relay service. BOOTP or DHCP requests are forwarded to the -list of servers specified. -.sp -\fIserver_addresses\fR is a comma separated list of hostnames and/or IP -addresses. -.RE - -.sp -.ne 2 -.na -\fB\fB-S\fR\fR -.ad -.RS 23n -Control the DHCP service. -.sp -The following sub-options are supported: -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.RS 6n - Disable and stop the DHCP service. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR\fR -.ad -.RS 6n -Enable and start the DHCP service. -.RE - -.sp -.ne 2 -.na -\fB\fB-q\fR\fR -.ad -.RS 6n -Display the state of the DHCP service. The state is encoded into the exit -status. -.sp -.in +2 -.nf -0 DHCP service disabled and stopped -1 DHCP service enabled and stopped -2 DHCP service disabled and running -3 DHCP service enabled and running -.fi -.in -2 -.sp - -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fR -.ad -.RS 6n -Enable and restart the DHCP service. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-U\fR\fR -.ad -.RS 23n -Unconfigure the DHCP service or BOOTP relay service. -.sp -The following sub-options are supported: -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.RS 6n -Do not prompt for confirmation. If \fB-f\fR is not used, a warning and -confirmation prompt is issued. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fR -.ad -.RS 6n -Delete hosts entries from name service. -.RE - -.sp -.ne 2 -.na -\fB\fB-x\fR\fR -.ad -.RS 6n -Delete the \fBdhcptab\fR and network tables. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-X\fR \fIfilename\fR\fR -.ad -.RS 23n -Export data from the DHCP data tables, saving to \fIfilename\fR, to move the -data to another Solaris DHCP server. -.sp -The following sub-options are optional: -.sp -.ne 2 -.na -\fB\fB-a\fR \fInetworks_to_export\fR\fR -.ad -.RS 25n -List of networks whose addresses should be exported, or the keyword ALL to -specify all networks. If \fB-a\fR is not specified, no networks are exported. -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR \fR -.ad -.RS 25n -Signal the daemon to reload the \fBdhcptab\fR after the export has been -completed. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR \fImacros_to_export\fR\fR -.ad -.RS 25n -List of macros to export, or the keyword \fBALL\fR to specify all macros. If -\fB-m\fR is not specified, no macros are exported. -.RE - -.sp -.ne 2 -.na -\fB\fB-o\fR \fIoptions_to_export\fR\fR -.ad -.RS 25n -List of options to export, or the keyword \fBALL\fR to specify all options. If -\fB-o\fR is not specified, no options are exported. -.RE - -.sp -.ne 2 -.na -\fB\fB-x\fR\fR -.ad -.RS 25n -Delete the data from this server after it is exported. If \fB-x\fR is not -specified you are in effect copying the data. -.RE - -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRConfiguring DHCP Service with Binary Files Data Store -.sp -.LP -The following command configures DHCP service, using the binary files data -store, in the DNS domain \fBacme.eng\fR, with a lease time of 28800 seconds (8 -hours), - -.sp -.in +2 -.nf -example# dhcpconfig -D -r SUNWbinfiles -p /var/dhcp -l 28800\e - -d acme.eng -a 120.30.33.4 -h dns -y acme.eng -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRConfiguring BOOTP Relay Agent -.sp -.LP -The following command configures the DHCP daemon as a BOOTP relay agent, which -forwards BOOTP and DHCP requests to the servers having the IP addresses -120.30.33.7 and 120.30.42.132: - -.sp -.in +2 -.nf -example# dhcpconfig -R 120.30.33.7,120.30.42.132 -.fi -.in -2 -.sp - -.LP -\fBExample 3 \fRUnconfiguring DHCP Service -.sp -.LP -The following command unconfigures the DHCP service, with confirmation, and -deletes the DHCP data tables and host table entries: - -.sp -.in +2 -.nf -example# dhcpconfig -U -x -h -.fi -.in -2 -.sp - -.LP -\fBExample 4 \fRConfiguring a Network for DHCP Service -.sp -.LP -The following command configures an additional LAN network for DHCP service, -specifying that clients should use router discovery and providing the NIS -domain name and NIS server address: - -.sp -.in +2 -.nf -example# dhcpconfig -N 120.30.171.0 -y east.acme.eng.com\e - -a 120.30.33.4 -.fi -.in -2 -.sp - -.LP -\fBExample 5 \fRConverting to SUNWnisplus Data Store -.sp -.LP -The following command converts a DHCP server from using a text or binary files -data store to a NIS+ data store, deleting the old data store's DHCP tables: - -.sp -.in +2 -.nf -example# dhcpconfig -C -r SUNWnisplus -p whatever.com. -.fi -.in -2 -.sp - -.LP -\fBExample 6 \fRExporting a Network, Macros, and Options from a DHCP Server -.sp -.LP -The following command exports one network (\fB120.30.171.0\fR) and its -addresses, the macro \fB120.30.171.0\fR, and the options \fBmotd\fR and -\fBPSptr\fRfrom a DHCP server, saves the exported data in file -\fB/export/var/120301710_data\fR, and deletes the exported data from the -server. - -.sp -.in +2 -.nf -example# dhcpconfig -X /var/dhcp/120301710_export - -a 120.30.171.0 -m 120.30.171.0 -o motd,PSptr -.fi -.in -2 -.sp - -.LP -\fBExample 7 \fRImporting Data on a DHCP Server -.sp -.LP -The following command imports DHCP data from a file, -\fB/net/golduck/export/var/120301710_data\fR, containing data previously -exported from a Solaris DHCP server, overwrites any conflicting data on the -importing server, and signals the daemon to reload the \fBdhcptab\fR once the -import is completed: - -.sp -.in +2 -.nf -example# dhcpconfig -I /net/golduck/export/var/120301710_data -f -g -.fi -.in -2 -.sp - -.LP -\fBExample 8 \fRSetting DHCP Server Parameters -.sp -.LP - The following command sets the number of minutes that the DHCP server waits -before timing out when updating DNS information on DHCP clients to five -minutes. - -.sp -.in +2 -.nf -example# example# dhcpconfig -P UPDATE_TIMEOUT=5 -.fi -.in -2 -.sp - -.LP -\fBExample 9 \fRRe-starting the DHCP server -.sp -.LP -The following command stops and re-starts the DHCP server. - -.sp -.in +2 -.nf -example# example# dhcpconfig -S -r -DHCP server stopped -DHCP server started -.fi -.in -2 -.sp - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdhcpmgr\fR(1M), \fBdhtadm\fR(1M), \fBin.dhcpd\fR(1M), \fBpntadm\fR(1M), -\fBdhcp_network\fR(4), \fBdhcptab\fR(4), \fBdhcpsvc.conf\fR(4), -\fBnsswitch.conf\fR(4), \fBresolv.conf\fR(4), \fBuser_attr\fR(4), -\fBattributes\fR(5), \fBdhcp\fR(5), \fBdhcp_modules\fR(5), \fBrbac\fR(5) -.sp -.LP -\fI\fR diff --git a/usr/src/man/man1m/dhcpmgr.1m b/usr/src/man/man1m/dhcpmgr.1m deleted file mode 100644 index f90906b7b6..0000000000 --- a/usr/src/man/man1m/dhcpmgr.1m +++ /dev/null @@ -1,164 +0,0 @@ -'\" te -.\" Copyright (c) 2001 Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DHCPMGR 1M "Mar 13, 2001" -.SH NAME -dhcpmgr \- graphical interface for managing DHCP service -.SH SYNOPSIS -.LP -.nf -\fB/usr/sadm/admin/bin/dhcpmgr\fR -.fi - -.SH DESCRIPTION -.sp -.LP -\fBdhcpmgr\fR is a graphical user interface which enables you to manage the -Dynamic Host Configuration Protocol (\fBDHCP\fR) service on the local system. -It performs the functions of the \fBdhcpconfig\fR, \fBdhtadm\fR, and -\fBpntadm\fR command line utilities. You must be \fBroot\fR to use -\fBdhcpmgr\fR. The \fBdhcpmgr\fR Help, available from the \fBHelp\fR menu, -contains detailed information about using the tool. -.SH USAGE -.sp -.LP -You can perform the following tasks using \fBdhcpmgr\fR: -.sp -.ne 2 -.na -\fBConfigure DHCP service\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to configure the DHCP daemon as a \fBDHCP\fR server, and -select the data store to use for storing network configuration tables.. -.RE - -.sp -.ne 2 -.na -\fBConfigure BOOTP relay service\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to configure the DHCP daemon as a \fBBOOTP\fR relay. -.RE - -.sp -.ne 2 -.na -\fBManage DHCP or BOOTP relay service\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to start, stop, enable, disable or unconfigure the \fBDHCP\fR -service or \fBBOOTP\fR relay service, or change DHCP server parameters. -.RE - -.sp -.ne 2 -.na -\fBManage DHCP addresses\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to add, modify, or delete \fBIP\fR addresses leased by the -\fBDHCP\fR service. -.RE - -.sp -.ne 2 -.na -\fBManage DHCP macros\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to add, modify or delete macros used to supply configuration -parameters to \fBDHCP\fR clients. -.RE - -.sp -.ne 2 -.na -\fBManage DHCP options\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to add, modify or delete options used to define parameters -deliverable through \fBDHCP\fR. -.RE - -.sp -.ne 2 -.na -\fBConvert to a new DHCP data store\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to configure the DHCP server to use a different data store, -and convert the DHCP data to the format used by the new data store. -.RE - -.sp -.ne 2 -.na -\fBMove DHCP data to another server\fR -.ad -.sp .6 -.RS 4n -Use \fBdhcpmgr\fR to export data from one Solaris DHCP server and import data -onto another Solaris DHCP server. -.RE - -.SH EXIT STATUS -.sp -.LP -The following exit values are returned: -.sp -.ne 2 -.na -\fB\fB0\fR \fR -.ad -.RS 13n -Successful completion. -.RE - -.sp -.ne 2 -.na -\fB\fBnon-zero\fR \fR -.ad -.RS 13n -An error occurred. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdhcpconfig\fR(1M), \fBdhtadm\fR(1M), \fBpntadm\fR(1M), \fBin.dhcpd\fR(1M), -\fBdhcpsvc.conf\fR(4), \fBdhcp_network\fR(4), \fBdhcptab\fR(4), -\fBattributes\fR(5), \fBdhcp\fR(5), \fBdhcp_modules\fR(5) -.sp -.LP -\fI\fR -.sp -.LP -\fI\fR diff --git a/usr/src/man/man1m/dhtadm.1m b/usr/src/man/man1m/dhtadm.1m deleted file mode 100644 index 9ff782808e..0000000000 --- a/usr/src/man/man1m/dhtadm.1m +++ /dev/null @@ -1,658 +0,0 @@ -'\" te -.\" Copyright (c) 2002 by Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DHTADM 1M "Aug 28, 2004" -.SH NAME -dhtadm \- DHCP configuration table management utility -.SH SYNOPSIS -.LP -.nf -\fBdhtadm\fR \fB-C\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-A\fR \fB-s\fR \fIsymbol_name\fR \fB-d\fR \fIdefinition\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-A\fR \fB-m\fR \fImacro_name\fR \fB-d\fR \fIdefinition\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-M\fR \fB-s\fR \fIsymbol_name\fR \fB-d\fR \fIdefinition\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-M\fR \fB-s\fR \fIsymbol_name\fR \fB-n\fR \fInew_name\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-M\fR \fB-m\fR \fImacro_name\fR \fB-n\fR \fInew_name\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] - [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-M\fR \fB-m\fR \fImacro_name\fR \fB-d\fR \fIdefinition\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-M\fR \fB-m\fR \fImacro_name\fR \fB-e\fR \fIsymbol=value\fR [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-D\fR \fB-s\fR \fIsymbol_name\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] - [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-D\fR \fB-m\fR \fImacro_name\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] - [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-P\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-R\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] [\fB-g\fR] -.fi - -.LP -.nf -\fBdhtadm\fR \fB-B\fR [\fB-v\fR] [\fIbatchfile\fR] [\fB-g\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -\fBdhtadm\fR manages the Dynamic Host Configuration Protocol (\fBDHCP\fR) -service configuration table, \fBdhcptab\fR. You can use it to add, delete, or -modify \fBDHCP\fR configuration macros or options or view the table. For a -description of the table format, see \fBdhcptab\fR(4).) -.sp -.LP -The \fBdhtadm\fR command can be run by root, or by other users assigned to the -DHCP Management profile. See \fBrbac\fR(5) and \fBuser_attr\fR(4). -.sp -.LP -After you make changes with \fBdhtadm\fR, you should issue a \fBSIGHUP\fR to -the DHCP server, causing it to read the \fBdhcptab\fR and pick up the changes. -Do this using the \fB-g\fR option. -.SH OPTIONS -.sp -.LP -One of the following function flags must be specified with the \fBdhtadm\fR -command: \fB-A\fR, \fB-B\fR, \fB-C\fR, \fB-D\fR, \fB-M\fR, \fB-P\fR or -\fB-R\fR. -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-A\fR \fR -.ad -.RS 27n -Add a symbol or macro definition to the \fBdhcptab\fR table. -.sp -The following sub-options are required: -.sp -.ne 2 -.na -\fB\fB-d\fR \fIdefinition\fR\fR -.ad -.RS 18n -Specify a macro or symbol definition. -.sp -\fIdefinition\fR must be enclosed in single quotation marks. For macros, use -the form \fB-d\fR -\fB\&':\fIsymbol\fR=\fIvalue\fR:\fIsymbol\fR=\fIvalue\fR:'\fR. Enclose a -\fIvalue\fR that contains colons in double quotation marks. For symbols, the -definition is a series of fields that define a symbol's characteristics. The -fields are separated by commas. Use the form \fB-d\fR -\fB\&'\fIcontext\fR,\fIcode\fR,\fItype\fR,\fIgranularity\fR,\fImaximum\fR'\fR. -See \fBdhcptab\fR(4) for information about these fields. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR \fImacro_name\fR\fR -.ad -.RS 18n -Specify the name of the macro to be added. -.sp -The \fB-d\fR option must be used with the \fB-m\fR option. The \fB-s\fR option -cannot be used with the \fB-m\fR option. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fIsymbol_name\fR\fR -.ad -.RS 18n -Specify the name of the symbol to be added. -.sp -The \fB-d\fR option must be used with the \fB-s\fR option. The \fB-m\fR option -cannot be used with the \fB-s\fR option. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-B\fR\fR -.ad -.RS 27n -Batch process \fBdhtadm\fR commands. \fBdhtadm\fR reads from the specified file -or from standard input a series of \fBdhtadm\fR commands and execute them -within the same process. Processing many \fBdhtadm\fR commands using this -method is much faster than running an executable batchfile itself. Batch mode -is recommended for using \fBdhtadm\fR in scripts. -.sp -The following sub-option is optional: -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.RS 6n -Display commands to standard output as they are processed. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR \fR -.ad -.RS 27n -Create the \fBDHCP\fR service configuration table, \fBdhcptab\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR \fR -.ad -.RS 27n -Delete a symbol or macro definition. -.sp -The following sub-options are required: -.sp -.ne 2 -.na -\fB\fB-m\fR \fImacro_name\fR\fR -.ad -.RS 18n -Delete the specified macro. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fIsymbol_name\fR\fR -.ad -.RS 18n -Delete the specified symbol. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-g\fR \fR -.ad -.RS 27n -Signal the DHCP daemon to reload the \fBdhcptab\fR after successful completion -of the operation. -.RE - -.sp -.ne 2 -.na -\fB\fB-M\fR \fR -.ad -.RS 27n -Modify an existing symbol or macro definition. -.sp -The following sub-options are required: -.sp -.ne 2 -.na -\fB\fB-d\fR \fIdefinition\fR\fR -.ad -.RS 17n -Specify a macro or symbol definition to modify. -.sp -The definition must be enclosed in single quotation marks. For macros, use the -form \fB-d\fR \fB\&':\fIsymbol\fR=\fIvalue\fR:\fIsymbol\fR=\fIvalue\fR:'\fR. -Enclose a \fIvalue\fR that contains colons in double quotation marks. For -symbols, the definition is a series of fields that define a symbol's -characteristics. The fields are separated by commas. Use the form \fB-d\fR -\fB\&'\fIcontext\fR,\fIcode\fR,\fItype\fR,\fIgranularity\fR,\fImaximum\fR'\fR. -See \fBdhcptab\fR(4) for information about these fields. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR\fR -.ad -.RS 17n -This sub-option uses the \fIsymbol\fR \fB=\fR\fIvalue\fR argument. Use it to -edit a \fIsymbol\fR/\fIvalue\fR pair within a macro. To add a symbol which does -not have an associate value, enter: -.sp -.in +2 -.nf -\fIsymbol\fR\fB=_NULL_VALUE_\fR -.fi -.in -2 -.sp - -To delete a symbol definition from a macro, enter: -.sp -.in +2 -.nf -\fIsymbol\fR\fB=\fR -.fi -.in -2 -.sp - -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR\fR -.ad -.RS 17n -This sub-option uses the \fImacro_name\fR argument. The \fB-n\fR, \fB-d\fR, or -\fB-e\fR sub-options are legal companions for this sub-option.. -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.RS 17n -This sub-option uses the \fInew_name\fR argument and modifies the name of the -object specified by the \fB-m\fR or \fB-s\fR sub-option. It is not limited to -macros. . Use it to specify a new macro name or symbol name. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR\fR -.ad -.RS 17n -This sub-option uses the \fIsymbol_name\fR argument. Use it to specify a -symbol. The \fB-d\fR sub-option is a legal companion. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR\fI path\fR \fR -.ad -.RS 27n -Override the \fBdhcpsvc.conf\fR(4) configuration value for \fBPATH=\fR with -\fIpath\fR. See \fBdhcpsvc.conf\fR(4) for more details regarding \fIpath\fR. -See \fBdhcp_modules\fR(5) for information regarding data storage modules for -the \fBDHCP\fR service. -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR \fR -.ad -.RS 27n -Print (display) the \fBdhcptab\fR table. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fI data_store_resource\fR \fR -.ad -.RS 27n -Override the \fBdhcpsvc.conf\fR(4) configuration value for \fBRESOURCE=\fR with -the \fIdata_store_resource\fR specified. See \fBdhcpsvc.conf\fR(4) for more -details on resource type. See\fI\fR for more information about adding support -for other data stores. See \fBdhcp_modules\fR(5) for information regarding data -storage modules for the \fBDHCP\fR service. -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR \fR -.ad -.RS 27n -Remove the \fBdhcptab\fR table. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR\fI uninterpreted\fR\fR -.ad -.RS 27n -Data which is ignored by \fBdhtadm\fR, but passed to currently configured -public module, to be interpreted by the data store. The private layer provides -for module-specific configuration information through the use of the -\fBRESOURCE_CONFIG\fR keyword. Uninterpreted data is stored within -\fBRESOURCE_CONFIG\fR keyword of \fBdhcpsvc.conf\fR(4). See -\fBdhcp_modules\fR(5) for information regarding data storage modules for the -DHCP service. -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRCreating the \fBDHCP\fR Service Configuration Table -.sp -.LP -The following command creates the \fBDHCP\fR service configuration table, -\fBdhcptab\fR: - -.sp -.in +2 -.nf -# dhtadm \fB-C\fR -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRAdding a Symbol Definition -.sp -.LP -The following command adds a \fBVendor\fR option symbol definition for a new -symbol called \fBMySym\fR to the \fBdhcptab\fR table in the \fBSUNWfiles\fR -resource in the \fB/var/mydhcp\fR directory: - -.sp -.in +2 -.nf -# dhtadm \fB-A\fR \fB-s\fR MySym - \fB-d\fR 'Vendor=SUNW.PCW.LAN,20,IP,1,0' - \fB-r\fR SUNWfiles \fB-p\fR /var/mydhcp -.fi -.in -2 -.sp - -.LP -\fBExample 3 \fRAdding a Macro Definition -.sp -.LP -The following command adds the \fBaruba\fR macro definition to the -\fBdhcptab\fR table. Note that symbol/value pairs are bracketed with colons -(\fB:\fR). - -.sp -.in +2 -.nf -# dhtadm \fB-A\fR \fB-m\fR aruba \e - \fB-d\fR ':Timeserv=10.0.0.10 10.0.0.11:DNSserv=10.0.0.1:' -.fi -.in -2 -.sp - -.LP -\fBExample 4 \fRModifying a Macro Definition -.sp -.LP -The following command modifies the \fBLocale\fR macro definition, setting the -value of the \fBUTCOffst\fR symbol to 18000 seconds. Note that any macro -definition which includes the definition of the \fBLocale\fR macro inherits -this change. - -.sp -.in +2 -.nf -# dhtadm \fB-M\fR \fB-m\fR Locale \fB-e\fR 'UTCOffst=18000' -.fi -.in -2 -.sp - -.LP -\fBExample 5 \fRDeleting a Symbol -.sp -.LP -The following command deletes the \fBTimeserv\fR symbol from the \fBaruba\fR -macro. Any macro definition which includes the definition of the \fBaruba\fR -macro inherits this change. - -.sp -.in +2 -.nf -# dhtadm \fB-M\fR \fB-m\fR aruba \fB-e\fR 'Timeserv=' -.fi -.in -2 -.sp - -.LP -\fBExample 6 \fRAdding a Symbol to a Macro -.sp -.LP -The following command adds the \fBHostname\fR symbol to the \fBaruba\fR macro. -Note that the \fBHostname\fR symbol takes no value, and thus requires the -special value \fB_NULL_VALUE_\fR. Note also that any macro definition which -includes the definition of the \fBaruba\fR macro inherits this change. - -.sp -.in +2 -.nf -# dhtadm \fB-M\fR \fB-m\fR aruba \fB-e\fR 'Hostname=_NULL_VALUE_' -.fi -.in -2 -.sp - -.LP -\fBExample 7 \fRRenaming a Macro -.sp -.LP -The following command renames the \fBLocale\fR macro to \fBMyLocale\fR. Note -that any \fBInclude\fR statements in macro definitions which include the -\fBLocale\fR macro also need to be changed. - -.sp -.in +2 -.nf -# dhtadm \fB-M\fR \fB-m\fR Locale \fB-n\fR MyLocale -.fi -.in -2 -.sp - -.LP -\fBExample 8 \fRDeleting a Symbol Definition -.sp -.LP -The following command deletes the \fBMySym\fR symbol definition. Note that any -macro definitions which use \fBMySym\fR needs to be modified. - -.sp -.in +2 -.nf -# dhtadm \fB-D\fR \fB-s\fR MySym -.fi -.in -2 -.sp - -.LP -\fBExample 9 \fRRemoving a dhcptab -.sp -.LP -The following command removes the \fBdhcptab\fR table in the NIS+ directory -specified. - -.sp -.in +2 -.nf -# dhtadm \fB-R\fR \fB-r\fR SUNWnisplus \fB-p\fR Test.Nis.Plus. -.fi -.in -2 -.sp - -.LP -\fBExample 10 \fRPrinting a dhcptab -.sp -.LP -The following command prints to standard output the contents of the -\fBdhcptab\fR that is located in the data store and path indicated in the -\fBdhcpsvc.conf\fR file:. - -.sp -.in +2 -.nf -# dhtadm \fB-P\fR -.fi -.in -2 -.sp - -.LP -\fBExample 11 \fRExecuting dhtadm in Batch Mode -.sp -.LP -The following command runs a series of \fBdhtadm\fR commands contained in a -batch file and signals the daemon to reload the \fBdhcptab\fR once the commands -have been executed: : - -.sp -.in +2 -.nf -# dhtadm -B addmacros -g -.fi -.in -2 -.sp - -.SH EXIT STATUS -.sp -.ne 2 -.na -\fB\fB0\fR \fR -.ad -.RS 6n -Successful completion. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR \fR -.ad -.RS 6n -Object already exists. -.RE - -.sp -.ne 2 -.na -\fB\fB2\fR \fR -.ad -.RS 6n -Object does not exist. -.RE - -.sp -.ne 2 -.na -\fB\fB3\fR \fR -.ad -.RS 6n -Non-critical error. -.RE - -.sp -.ne 2 -.na -\fB\fB4\fR \fR -.ad -.RS 6n -Critical error. -.RE - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/inet/dhcpsvc.conf\fR \fR -.ad -.RS 27n - -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdhcpconfig\fR(1M), \fBdhcpmgr\fR(1M), \fBin.dhcpd\fR(1M), -\fBdhcpsvc.conf\fR(4), \fBdhcp_network\fR(4), \fBdhcptab\fR(4), \fBhosts\fR(4), -\fBuser_attr\fR(4), \fBattributes\fR(5), \fBdhcp\fR(5), -\fBdhcp_modules\fR(5)\fBrbac\fR(5) -.sp -.LP -\fI\fR -.sp -.LP -\fI\fR -.sp -.LP -Alexander, S., and R. Droms, \fIDHCP Options and BOOTP Vendor Extensions\fR, -RFC 1533, Lachman Technology, Inc., Bucknell University, October 1993. -.sp -.LP -Droms, R., \fIInteroperation Between DHCP and BOOTP\fR, RFC 1534, Bucknell -University, October 1993. -.sp -.LP -Droms, R., \fIDynamic Host Configuration Protocol\fR, RFC 1541, Bucknell -University, October 1993. -.sp -.LP -Wimer, W., \fIClarifications and Extensions for the Bootstrap Protocol\fR, RFC -1542, Carnegie Mellon University, October 1993. diff --git a/usr/src/man/man1m/dsvclockd.1m b/usr/src/man/man1m/dsvclockd.1m deleted file mode 100644 index 3fec91a004..0000000000 --- a/usr/src/man/man1m/dsvclockd.1m +++ /dev/null @@ -1,82 +0,0 @@ -'\" te -.\" Copyright (c) 2001, Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH DSVCLOCKD 1M "Dec 3, 2001" -.SH NAME -dsvclockd \- DHCP service lock daemon -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/inet/dsvclockd\fR [\fB-d\fR 1 | 2] [\fB-f\fR ] [\fB-v\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBdsvclockd\fR daemon is a lock manager that works in conjunction with the -Dynamic Host Configuration Protocol (\fBDHCP\fR) Data Service Library -(\fBlibdhcpsvc\fR). It provides shared or exclusive access to the -\fBdhcp_network\fR(4) and \fBdhcptab\fR(4) tables. This service is used by the -\fBSUNWbinfiles\fR and \fBSUNWfiles\fR \fBDHCP\fR data store modules. See -\fBdhcp_modules\fR(5). -.sp -.LP -\fBdsvclockd\fR is started on demand by \fBlibdhcpsvc\fR. The \fBdsvclockd\fR -daemon should be started manually only if command line options need to be -specified. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-d\fR \fB1\fR | \fB2\fR\fR -.ad -.RS 12n -Set debug level. Two levels of debugging are currently available, \fB1\fR and -\fB2\fR. Level \fB2\fR is more verbose. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR\fR -.ad -.RS 12n -Run in the foreground instead of as a daemon process. When this option is used, -messages are sent to standard error instead of to \fBsyslog\fR(3C). -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.RS 12n -Provide verbose output. -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Unstable -.TE - -.SH SEE ALSO -.sp -.LP -\fBsyslog\fR(3C), \fBdhcp_network\fR(4), \fBdhcptab\fR(4), -\fBdhcp_modules\fR(5), \fBattributes\fR(5) diff --git a/usr/src/man/man1m/in.dhcpd.1m b/usr/src/man/man1m/in.dhcpd.1m deleted file mode 100644 index 09152473f2..0000000000 --- a/usr/src/man/man1m/in.dhcpd.1m +++ /dev/null @@ -1,496 +0,0 @@ -'\" te -.\" Copyright (c) 2004 by Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH IN.DHCPD 1M "Aug 10, 2004" -.SH NAME -in.dhcpd \- Dynamic Host Configuration Protocol server -.SH SYNOPSIS -.LP -.nf -\fB/usr/lib/inet/in.dhcpd\fR [\fB-denv\fR] [\fB-h\fR \fIrelay_hops\fR] [\fB-i\fR \fIinterface,\fR ...] - [\fB-l\fR \fIsyslog_local_facility\fR] [\fB-b\fR automatic | manual] - [\fB-o\fR \fIDHCP_offer_time\fR] [\fB-t\fR \fIdhcptab_rescan_interval\fR] -.fi - -.LP -.nf -\fB/usr/lib/inet/in.dhcpd\fR [\fB-dv\fR] [\fB-h\fR \fIrelay_hops\fR] [\fB-i\fR \fIinterface,\fR]... - [\fB-l\fR \fIsyslog_local_facility\fR] \fB-r\fR \fIIP_address\fR | \fIhostname,\fR ... -.fi - -.SH DESCRIPTION -.sp -.LP -\fBin.dhcpd\fR is a daemon that responds to Dynamic Host Configuration Protocol -(\fBDHCP\fR) requests and optionally to \fBBOOTP\fR protocol requests. The -daemon forks a copy of itself that runs as a background process. It must be run -as root. The daemon has two run modes, \fBDHCP\fR server (with optional -\fBBOOTP\fR compatibility mode) and \fBBOOTP\fR relay agent mode. -.sp -.LP -The first line in the \fBSYNOPSIS\fR section illustrates the options available -in the DHCP/BOOTP server mode. The second line in the SYNOPSIS section -illustrates the options available when the daemon is run in \fBBOOTP\fR relay -agent mode. -.sp -.LP -The \fBDHCP\fR and \fBBOOTP\fR protocols are used to provide configuration -parameters to Internet hosts. Client machines are allocated their \fBIP\fR -addresses as well as other host configuration parameters through this -mechanism. -.sp -.LP -The \fBDHCP\fR/\fBBOOTP\fR daemon manages two types of \fBDHCP\fR data tables: -the \fBdhcptab\fR configuration table and the DHCP network tables. -.sp -.LP -See \fBdhcptab\fR(4) regarding the dhcptab configuration table and -\fBdhcp_network\fR(4) regarding the \fBDHCP\fR network tables. -.sp -.LP -The \fBdhcptab\fR contains macro definitions defined using a \fBtermcap\fR-like -syntax which permits network administrators to define groups of \fBDHCP\fR -configuration parameters to be returned to clients. However, a \fBDHCP/BOOTP\fR -server always returns hostname, network broadcast address, network subnet mask, -and \fBIP\fR maximum transfer unit (\fBMTU\fR) if requested by a client -attached to the same network as the server machine. If those options have not -been explicitly configured in the \fBdhcptab\fR, \fBin.dhcpd\fR returns -reasonable default values. -.sp -.LP -The \fBdhcptab\fR is read at startup, upon receipt of a \fBSIGHUP\fR signal, or -periodically as specified by the \fB-t\fR option. A \fBSIGHUP\fR (sent using -the command \fBsvcadm refresh network/dhcp-server\fR) causes the DHCP/BOOTP -daemon to reread the \fBdhcptab\fR within an interval from \fB0\fR-\fB60\fR -seconds (depending on where the DHCP daemon is in its polling cycle). For busy -servers, users should run \fBsvcadm restart network/dhcp-server\fR to force the -\fBdhcptab\fR to be reread. -.sp -.LP -The DHCP network tables contain mappings of client identifiers to \fBIP\fR -addresses. These tables are named after the network they support and the -datastore used to maintain them. -.sp -.LP -The DHCP network tables are consulted during runtime. A client request received -from a network for which no DHCP network table exists is ignored. -.sp -.LP -This command may change in future releases of Solaris software. Scripts, -programs, or procedures that use this command might need modification when -upgrading to future Solaris software releases.The command line options provided -with the \fBin.dhcpd\fR daemon are used only for the current session, and -include only some of the server options you can set. The \fBdhcpsvc.conf\fR(4) -contains all the server default settings, and can be modified by using the -\fBdhcpmgr\fR utility. See \fBdhcpsvc.conf\fR(4) for more details. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-b\fR \fB automatic | manual\fR\fR -.ad -.sp .6 -.RS 4n -This option enables \fBBOOTP\fR compatibility mode, allowing the \fBDHCP\fR -server to respond to \fBBOOTP\fR clients. The option argument specifies whether -the \fBDHCP\fR server should automatically allocate permanent lease \fBIP\fR -addresses to requesting \fBBOOTP\fR clients if the clients are not registered -in the DHCP network tables (\fBautomatic\fR) or respond only to \fBBOOTP\fR -clients who have been manually registered in the DHCP network tables (\fB -manual\fR). This option only affects \fBDHCP\fR server mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-d\fR\fR -.ad -.sp .6 -.RS 4n -Debugging mode. The daemon remains as a foreground process, and displays -verbose messages as it processes \fBDHCP\fR and/or \fBBOOTP\fR datagrams. -Messages are displayed on the current TTY. This option can be used in both -DHCP/BOOTP server mode and \fBBOOTP\fR relay agent mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR\fI relay_hops\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the maximum number of relay agent hops that can occur before the -daemon drops the DHCP/BOOTP datagram. The default number of relay agent hops is -4. This option affects both DHCP/BOOTP server mode and \fBBOOTP\fR relay agent -mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR\fI interface, .\|.\|.\fR\fR -.ad -.sp .6 -.RS 4n -Selects the network interfaces that the daemon should monitor for DHCP/BOOTP -datagrams. The daemon ignores DHCP/BOOTP datagrams on network interfaces not -specified in this list. This option is only useful on machines that have -multiple network interfaces. If this option is not specified, then the daemon -listens for DHCP/BOOTP datagrams on all network interfaces. The option argument -consists of a comma-separated list of interface names. It affects both -DHCP/BOOTP server and \fBBOOTP\fR relay agent run modes. -.RE - -.sp -.ne 2 -.na -\fB\fB-l\fR \fIsyslog_local_facility\fR\fR -.ad -.sp .6 -.RS 4n -The presence of this option turns on transaction logging for the \fBDHCP\fR -server or \fBBOOTP\fR relay agent. The value specifies the \fBsyslog\fR local -facility (an integer from \fB0\fR to \fB7\fR inclusive) the DHCP daemon should -use for tagging the transactions. Using a facility separate from the -\fBLOG_DAEMON\fR facility allows the network administrator to capture these -transactions separately from other DHCP daemon events for such purposes as -generating transaction reports. See \fBsyslog\fR(3C), for details about local -facilities. Transactions are logged using a record with 9 space-separated -fields as follows: -.RS +4 -.TP -1. -Protocol: -.sp -.in +2 -.nf - Relay mode: "BOOTP" - Server mode: "BOOTP" or "DHCP" based upon client - type. -.fi -.in -2 -.sp - -.RE -.RS +4 -.TP -2. -Type: -.sp -.in +2 -.nf -Relay mode: "RELAY-CLNT", "RELAY-SRVR" -Server mode: "ASSIGN", "EXTEND", "RELEASE", - "DECLINE", "INFORM", "NAK" "ICMP-ECHO." -.fi -.in -2 -.sp - -.RE -.RS +4 -.TP -3. -Transaction time: absolute time in seconds (unix time) -.RE -.RS +4 -.TP -4. -Lease time: -.sp -.in +2 -.nf -Relay mode: Always 0. -Server mode: 0 for ICMP-ECHO events, absolute time in - seconds (unix time) otherwise -.fi -.in -2 -.sp - -.RE -.RS +4 -.TP -5. -Source IP address: Dotted Internet form -.LP -.nf -Relay mode: Relay interface IP on RELAY-CLNT, INADDR_ANY on RELAY-SRVR. Server mode: Client IP. -.fi - -.RE -.RS +4 -.TP -6. -Destination IP address: Dotted Internet form -.LP -.nf -Relay mode: Client IP on RELAY-CLNT, Server IP on RELAY-SRVR. Server mode: Server IP. -.fi - -.RE -.RS +4 -.TP -7. -Client Identifier: Hex representation (0-9, A-F) -.LP -.nf -Relay mode: MAC address Server mode: BOOTP - MAC address; DHCP - client id -.fi - -.RE -.RS +4 -.TP -8. -Vendor Class identifier (white space converted to -periods (.)). -.LP -.nf -Relay mode: Always "N/A" Server mode: Vendor class ID tokenized by converting white space characters to periods (.) -.fi - -.RE -.RS +4 -.TP -9. -MAC address: Hex representation (0-9, A-F) -.LP -.nf -Relay mode: MAC address Server mode: MAC address -.fi - -.RE -The format of this record is subject to change between releases. -.sp -Transactions are logged to the console if daemon is in debug mode (\fB-d\fR). -.sp -Logging transactions impact daemon performance. -.sp -It is suggested that you periodically rotate the DHCP transaction log file to -keep it from growing until it fills the filesystem. This can be done in a -fashion similar to that used for the general system message log -\fB/var/adm/messages\fR and is best accomplished using the facilities provided -by \fBlogadm\fR(1M). -.RE - -.sp -.ne 2 -.na -\fB\fB-n\fR\fR -.ad -.sp .6 -.RS 4n -Disable automatic duplicate \fBIP\fR address detection. When this option is -specified, the \fBDHCP\fR server does not attempt to verify that an \fBIP -address it is about to\fR offer a client is not in use. By default, the -\fBDHCP\fR server pings an \fBIP\fR address before offering it to a DHCP/BOOTP -client, to verify that the address is not in use by another machine. -.RE - -.sp -.ne 2 -.na -\fB\fB-o\fR\fI DHCP_offer_time\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the number of seconds the \fBDHCP\fR server should cache the offers -it has extended to discovering \fBDHCP\fR clients. The default setting is -\fB10\fR seconds. On slow network media, this value can be increased to -compensate for slow network performance. This option affects only \fBDHCP\fR -server mode. -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR\fI IP_address | hostname, .\|.\|.\fR\fR -.ad -.sp .6 -.RS 4n -This option enables \fBBOOTP\fR relay agent mode. The option argument specifies -a comma-separated list of \fBIP\fR addresses or hostnames of \fBDHCP\fR or -\fBBOOTP\fR servers to which the relay agent is to forward \fBBOOTP\fR -requests. When the daemon is started in this mode, any \fBDHCP\fR tables are -ignored, and the daemon simply acts as a \fBBOOTP\fR relay agent. -.sp -A \fBBOOTP\fR relay agent listens to \fBUDP\fR port 68, and forwards -\fBBOOTP\fR request packets received on this port to the destinations specified -on the command line. It supports the \fBBROADCAST\fR flag described in -\fBRFC\fR 1542. A \fBBOOTP\fR relay agent can run on any machine that has -knowledge of local routers, and thus does not have to be an Internet gateway -machine. -.sp -Note that the proper entries must be made to the \fBnetmasks\fR database so -that the \fBDHCP\fR server being served by the \fBBOOTP\fR relay agents can -identify the subnet mask of the foreign BOOTP/DHCP client's network. See -\fBnetmasks\fR(4) for the format and use of this database. -.RE - -.sp -.ne 2 -.na -\fB\fB-t\fR\fI dhcptab_rescan_interval\fR\fR -.ad -.sp .6 -.RS 4n -Specifies the interval in minutes that the \fBDHCP\fR server should use to -schedule the automatic rereading of the \fBdhcptab\fR information. Typically, -you would use this option if the changes to the \fBdhcptab\fR are relatively -frequent. Once the contents of the \fBdhcptab\fR have stabilized, you can turn -off this option to avoid needless reinitialization of the server. -.RE - -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.sp .6 -.RS 4n -Verbose mode. The daemon displays more messages than in the default mode. Note -that verbose mode can reduce daemon efficiency due to the time taken to display -messages. Messages are displayed to the current \fBTTY\fR if the debugging -option is used; otherwise, messages are logged to the \fBsyslogd\fR facility. -This option can be used in both DHCP/BOOTP server mode and \fBBOOTP\fR relay -agent mode. -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRStarting a \fBDHCP\fR Server in \fBBOOTP\fR Compatibility Mode -.sp -.LP -The following command starts a \fBDHCP\fR server in \fBBOOTP\fR compatibility -mode, permitting the server to automatically allocate permanent \fBIP\fR -addresses to \fBBOOTP\fR clients which are not registered in the server's -table; limits the server's attention to incoming datagrams on network devices -\fBle2\fR and \fBtr0\fR; drops \fBBOOTP\fR packets whose hop count exceeds 2; -configures the \fBDHCP\fR server to cache extended \fBDHCP\fR offers for 15 -seconds; and schedules \fBdhcptab\fR rescans to occur every 10 minutes: - -.sp -.in +2 -.nf -\fB# in.dhcpd \fR\fB-i\fR\fB le2,tr0 \fR\fB-h\fR\fB 2 \fR\fB-o\fR\fB 15 \fR\fB-t\fR\fB 10 \fR\fB-b\fR\fB automatic\fR -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRStarting the Daemon in \fBBOOTP\fR Relay Agent Mode -.sp -.LP -The following command starts the daemon in \fBBOOTP\fR relay agent mode, -registering the hosts \fBbladerunner\fR and \fB10.0.0.5\fR as relay -destinations, with debugging and verbose modes enabled, and drops \fBBOOTP\fR -packets whose hop count exceeds 5: - -.sp -.in +2 -.nf -\fB# in.dhcpd \fR\fB-d\fR\fB \fR\fB-v\fR\fB \fR\fB-h\fR\fB 5 \fR\fB-r\fR\fB bladerunner,10.0.0.5\fR -.fi -.in -2 -.sp - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/inet/dhcpsvc.conf\fR\fR -.ad -.sp .6 -.RS 4n - -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/init/hosts\fR\fR -.ad -.sp .6 -.RS 4n - -.RE - -.sp -.ne 2 -.na -\fB\fB/usr/lib/inet/dhcp/nsu/rfc2136.so.1\fR\fR -.ad -.sp .6 -.RS 4n - -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBsvcs\fR(1), \fBcron\fR(1M), \fBdhcpmgr\fR(1M), \fBdhtadm\fR(1M), -\fBinetadm\fR(1M), \fBinetd\fR(1M), \fBlogadm\fR(1M), \fBpntadm\fR(1M), -\fBsvcadm\fR(1M), \fBsyslogd\fR(1M), \fBsyslog\fR(3C), \fBdhcpsvc.conf\fR(4), -\fBdhcp_network\fR(4), \fBdhcptab\fR(4), \fBethers\fR(4), \fBhosts\fR(4), -\fBnetmasks\fR(4), \fBnsswitch.conf\fR(4), \fBattributes\fR(5), \fBdhcp\fR(5), -\fBsmf\fR(5) -.sp -.LP -\fI\fR -.sp -.LP -Alexander, S., and R. Droms, \fIDHCP Options and BOOTP Vendor Extensions\fR, -RFC 2132, Silicon Graphics, Inc., Bucknell University, March 1997. -.sp -.LP -Droms, R., \fIInteroperation Between DHCP and BOOTP\fR, RFC 1534, Bucknell -University, October 1993. -.sp -.LP -Droms, R., \fIDynamic Host Configuration Protocol\fR, RFC 2131, Bucknell -University, March 1997. -.sp -.LP -Wimer, W., \fIClarifications and Extensions for the Bootstrap Protocol\fR, RFC -1542, Carnegie Mellon University, October 1993. -.SH NOTES -.sp -.LP -The \fBin.dhcpd\fR service is managed by the service management facility, -\fBsmf\fR(5), under the service identifier: -.sp -.in +2 -.nf -svc:/network/dhcp-server -.fi -.in -2 -.sp - -.sp -.LP -Administrative actions on this service, such as enabling, disabling, or -requesting restart, can be performed using \fBsvcadm\fR(1M). Responsibility for -initiating and restarting this service is delegated to \fBinetd\fR(1M). Use -\fBinetadm\fR(1M) to make configuration changes and to view configuration -information for this service. The service's status can be queried using the -\fBsvcs\fR(1) command. diff --git a/usr/src/man/man1m/pntadm.1m b/usr/src/man/man1m/pntadm.1m deleted file mode 100644 index f50b753dd8..0000000000 --- a/usr/src/man/man1m/pntadm.1m +++ /dev/null @@ -1,737 +0,0 @@ -'\" te -.\" Copyright (c) 2003 by Sun Microsystems, Inc. All Rights Reserved. -.\" The contents of this file are subject to the terms of the Common Development and Distribution License (the "License"). You may not use this file except in compliance with the License. -.\" You can obtain a copy of the license at usr/src/OPENSOLARIS.LICENSE or http://www.opensolaris.org/os/licensing. See the License for the specific language governing permissions and limitations under the License. -.\" When distributing Covered Code, include this CDDL HEADER in each file and include the License file at usr/src/OPENSOLARIS.LICENSE. If applicable, add the following below this CDDL HEADER, with the fields enclosed by brackets "[]" replaced with your own identifying information: Portions Copyright [yyyy] [name of copyright owner] -.TH PNTADM 1M "Jan 9, 2004" -.SH NAME -pntadm \- DHCP network table management utility -.SH SYNOPSIS -.LP -.nf -\fBpntadm\fR \fB-C\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-A\fR \fIname_IP_address\fR [\fB-c\fR \fIcomment\fR] [\fB-e\fR \fImm/dd/yyyy\fR] - [\fB-f\fR \fInum\fR | \fIkeywords\fR] [\fB-h\fR \fIclient_hostname\fR] - [\fB-i\fR [\fB-a\fR] \fIclient_ID\fR] [\fB-m\fR [\fB-y\fR] \fImacro\fR] [\fB-s\fR \fIserver\fR] - [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR \fIuninterpreted\fR] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-M\fR \fIname_IP_address\fR [\fB-c\fR \fIcomment\fR] [\fB-e\fR \fImm/dd/yyyy\fR] - [\fB-f\fR \fInum\fR | \fIkeywords\fR] [\fB-h\fR \fIclient_hostname\fR] - [\fB-i\fR [\fB-a\fR] \fIclient\fR \fI ID\fR] [\fB-m\fR [\fB-y\fR] \fImacro\fR] - [\fB-n\fR \fInew_client_IP_address\fR] [\fB-s\fR \fIserver\fR] [\fB-r\fR \fIresource\fR] - [\fB-p\fR \fIpath\fR] [\fB-u\fR uninterpreted] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-D\fR \fIname_IP_address\fR [\fB-y\fR] [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] - [\fB-u\fR uninterpreted] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-P\fR [\fB-v\fR] [\fB-x\fR] [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] - [\fB-u\fR uninterpreted] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-R\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR uninterpreted] \fInetwork\fR -.fi - -.LP -.nf -\fBpntadm\fR \fB-L\fR [\fB-r\fR \fIresource\fR] [\fB-p\fR \fIpath\fR] [\fB-u\fR uninterpreted] -.fi - -.LP -.nf -\fBpntadm\fR \fB-B\fR [\fB-v\fR] [\fIbatchfile\fR] -.fi - -.SH DESCRIPTION -.sp -.LP -The \fBpntadm\fR command is used to manage the Dynamic Host Configuration -Protocol (\fBDHCP\fR) network tables. It is used to add and remove networks -under \fBDHCP\fR management, and add, delete, or modify IP address records -within network tables, or to view tables. For a description of the format of -\fBDHCP\fR network tables, see \fBdhcp_network\fR(4). -.sp -.LP -\fBpntadm\fR can be run as root or by other users assigned to the \fBDHCP\fR -Management profile. See \fBrbac\fR(5) and \fBuser_attr\fR(4). -.sp -.LP -If the networks you want to add are subnetted, you need to update the -\fBnetmasks\fR(4) table. -.sp -.LP -One of the following options (function flags) must be specified with the -\fBpntadm\fR command: \fB-A\fR, \fB-B\fR, \fB-C\fR, \fB-D\fR, \fB-L\fR, -\fB-M\fR, \fB-P\fR, or\fB-R\fR. -.SH OPTIONS -.sp -.LP -The following options are supported: -.sp -.ne 2 -.na -\fB\fB-A\fR\fI name_IP_address\fR\fR -.ad -.RS 26n -Add a client entry with hostname or client IP address, \fIname_IP_address\fR, -to the named \fBDHCP\fR network table. -.sp -The following sub-options are optional: -.sp -.ne 2 -.na -\fB\fB-c\fR \fIcomment\fR\fR -.ad -.RS 22n -Comment text. The default is \fINULL\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR \fImm/dd/yyyy\fR\fR -.ad -.RS 22n -Absolute lease. The default is \fB0\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR \fInum\fR | \fIkeywords\fR\fR -.ad -.RS 22n -Flag value. The default is \fB00\fR. -.sp -The flag (\fB-f\fR) option can be specified either as a single number denoting -the intended flag value, or as a series of the following keywords, combined -using the plus (\fB+\fR) symbol: -.sp -.ne 2 -.na -\fB\fBDYNAMIC\fR or \fB00\fR\fR -.ad -.RS 19n -Server manager's assignment. -.RE - -.sp -.ne 2 -.na -\fB\fBPERMANENT\fR or \fB01\fR\fR -.ad -.RS 19n -Lease on entry is permanent. -.RE - -.sp -.ne 2 -.na -\fB\fBMANUAL\fR or \fB02\fR\fR -.ad -.RS 19n -Administrator managed assignment. -.RE - -.sp -.ne 2 -.na -\fB\fBUNUSABLE\fR or \fB04\fR\fR -.ad -.RS 19n -Entry is not valid. -.RE - -.sp -.ne 2 -.na -\fB\fBBOOTP\fR or \fB08\fR\fR -.ad -.RS 19n -Entry reserved for \fBBOOTP\fR clients. -.RE - -For a more detailed description of the flag values, see \fBdhcp_network\fR(4). -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR \fIclient_hostname\fR\fR -.ad -.RS 22n -Client hostname. The default is NULL. -.sp -When the \fB-h\fR option is used in this mode, the \fIclient_hostname\fR is -added to the hosts table within the resource used for storing host names -(files, NIS+ or DNS). The command will fail if this \fIclient_hostname\fR is -already present in the hosts table. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR \fIclient_ID\fR [\fB-a\fR]\fR -.ad -.RS 22n -Client identifier [\fB-a\fR]. The default is \fB00\fR. -.sp -The \fB-i\fR option modified with \fB-a\fR specifies that the client identifier -is in \fBASCII\fR format, and thus needs to be converted to hexadecimal format -before insertion into the table. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR \fImacro\fR [\fB-y\fR]\fR -.ad -.RS 22n -Macro name. Default is UNKNOWN. -.sp -The \fB-m\fR option modified with \fB-y\fR verifies the existence of the named -macro in the \fBdhcptab\fR table before adding the entry. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fIserver\fR\fR -.ad -.RS 22n -Server IP or name. Default is system name (\fBuname\fR \fB-n\fR). -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-B\fR\fR -.ad -.RS 26n -Activate batch mode. \fBpntadm\fR will read from the specified file or from -standard input a series of \fBpntadm\fR commands and execute them within the -same process. Processing many \fBpntadm\fR commands using this method is much -faster than running an executable batchfile itself. Batch mode is recommended -for using \fBpntadm\fR in scripts. -.sp -The following sub-option is optional: -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.RS 6n -Display commands to standard output as they are processed. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-C\fR\fR -.ad -.RS 26n -Create the \fBDHCP\fR network table for the network specified by \fInetwork\fR. -See . For details, see \fBdhcp_network\fR(4) and \fBnetworks\fR(4). -.RE - -.sp -.ne 2 -.na -\fB\fB-D\fR \fI name_IP_address\fR\fR -.ad -.RS 26n -Delete the specified client entry with hostname or client IP address, -\fIname_IP_address\fR, in the named \fBDHCP\fR network table. (See -\fBdhcp_network\fR(4).) -.sp -The following sub-option is optional: -.sp -.ne 2 -.na -\fB\fB-y\fR\fR -.ad -.RS 6n -Remove associated host table entry. The \fB-y\fR option requests that all -hostnames associated with the \fBIP\fR address in the hosts table in the -resource be removed. -.RE - -.RE - -.sp -.ne 2 -.na -\fB\fB-L\fR\fR -.ad -.RS 26n -List the \fBDHCP\fR network tables presently configured, one per line, on -standard output. If none are found, no output is printed and an exit status of -\fB0\fR is returned. -.RE - -.sp -.ne 2 -.na -\fB\fB-M\fR \fI name_IP_address\fR\fR -.ad -.RS 26n -Modify the specified client entry with hostname or client IP address, -\fIname_IP_address\fR, in the named \fBDHCP\fR network table. See -\fBdhcp_network\fR(4). The default for the sub-options is what they currently -are set to. -.sp -The following sub-options are optional. -.sp -.ne 2 -.na -\fB\fB-c\fR \fIcomment\fR\fR -.ad -.RS 29n -New comment text. -.RE - -.sp -.ne 2 -.na -\fB\fB-e\fR \fImm/dd/yy\fR\fR -.ad -.RS 29n -New absolute lease expiration date. Time defaults to 12:00 AM of the day -specified. -.RE - -.sp -.ne 2 -.na -\fB\fB-f\fR \fInum\fR | \fIkeyboard\fR\fR -.ad -.RS 29n -New flag value, see explanation following the description of the \fB-A\fR -option. -.RE - -.sp -.ne 2 -.na -\fB\fB-h\fR \fIhost_name\fR\fR -.ad -.RS 29n -New client hostname. -.sp -The \fB-h\fR option allows you to change the current \fIhostname\fR associated -with the \fBIP\fR address or to add a new \fIhostname\fR to the hosts table if -an entry associated with this \fBIP\fR address does not exist. -.RE - -.sp -.ne 2 -.na -\fB\fB-i\fR \fIclient_ID\fR\fR -.ad -.RS 29n -New client identifier [\fB-a\fR]. -.RE - -.sp -.ne 2 -.na -\fB\fB-m\fR \fImacro\fR [\fB-y\fR]\fR -.ad -.RS 29n -Macro name defined in \fBdhcptab\fR. -.RE - -.sp -.ne 2 -.na -\fB\fB-n \fR \fInew_client_IP_address\fR\fR -.ad -.RS 29n -New \fBIP\fR address. -.RE - -.sp -.ne 2 -.na -\fB\fB-s\fR \fIserver\fR\fR -.ad -.RS 29n -New server \fBIP\fR or name. -.RE - - For more detailed description of the sub-options and flag values, see -\fBdhcp_network\fR(4). -.RE - -.sp -.ne 2 -.na -\fB\fB-P\fR\fR -.ad -.RS 26n -Display the named \fBDHCP\fR network table. -.sp -The following sub-options are optional: -.sp -.ne 2 -.na -\fB\fB-v\fR\fR -.ad -.RS 6n -Display lease time in full verbose format and resolve IP addresses for the -clients and server to hostnames. -.RE - -.sp -.ne 2 -.na -\fB\fB-x\fR\fR -.ad -.RS 6n -Display lease time in raw format. -.RE - -These flag codes are used with the \fB-P\fR sub-options: -.sp - -.sp -.TS -l l l -l l l . -\fB-v\fR \fB-x\fR Description -D 00 DYNAMIC -P 01 PERMANENT -M 02 MANUAL -U 04 UNUSABLE -B 08 BOOTP -.TE - -See \fBdhcp_network\fR(4) for information on these sub-options and associated -flag codes. -.RE - -.sp -.ne 2 -.na -\fB\fB-p\fR\fI path\fR\fR -.ad -.RS 26n -Override the \fBdhcpsvc.conf\fR(4) configuration value for data store resource -path, \fIpath\fR See \fBdhcpsvc.conf\fR(4) -.RE - -.sp -.ne 2 -.na -\fB\fB-R\fR\fR -.ad -.RS 26n -Remove the named DHCP network table. See \fBdhcp_network\fR(4). -.RE - -.sp -.ne 2 -.na -\fB\fB-r\fR \fIdata_store_resource\fR\fR -.ad -.RS 26n -Override the \fB/etc/inet/dhcpsvc.conf\fR configuration value for -\fBRESOURCE=\fR with the \fIdata_store_resource\fR specified. See the -\fBdhcpsvc.conf\fR(4) man page for more details on resource type, and the -\fI\fR for more information about adding support for other data stores. -.RE - -.sp -.ne 2 -.na -\fB\fB-u\fR uninterpreted\fR -.ad -.RS 26n -Data which will be ignored by \fBpntadm\fR, but passed to the currently -configured public module to be interpreted by the data store. This might be -used for a database account name or other authentication or authorization -parameters required by a particular data store. -.RE - -.SH OPERANDS -.sp -.LP -The following operand is supported: -.sp -.ne 2 -.na -\fB\fInetwork\fR\fR -.ad -.RS 11n -The network address or network name which corresponds to the \fBdhcp network\fR -table. See \fBdhcp_network\fR(4). -.RE - -.SH EXAMPLES -.LP -\fBExample 1 \fRCreating a Table for the \fB10.0.0.0\fR DHCP Network -.sp -.LP -The following command creates a table for the \fB10.0.0.0\fR (subnetted to -class C) \fBDHCP\fR network table. Note that if you have an alias for this -network in your \fBnetworks\fR(4) table, you can use that value rather than the -dotted Internet Address notation. - -.sp -.in +2 -.nf -example# \fBpntadm -C 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 2 \fRAdding an Entry to the \fB10.0.0.0\fR Table -.sp -.LP -The following command adds an entry to the \fB10.0.0.0\fR table in the -\fBfiles\fR resource in the \fB/var/mydhcp\fR directory: - -.sp -.in +2 -.nf -example# \fBpntadm -r SUNWfiles -p /var/mydhcp -A 10.0.0.1 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 3 \fRModifying the \fB10.0.0.1\fR Entry of the \fB10.0.0.0\fR Table -.sp -.LP -The following command modifies the \fB10.0.0.1\fR entry of the \fB10.0.0.0\fR -table, changing the macro name to \fBGreen\fR, setting the flags field to -\fBMANUAL\fR and \fBPERMANENT:\fR - -.sp -.in +2 -.nf -example# \fBpntadm -M 10.0.0.1 -m Green -f 'PERMANENT+MANUAL' 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 4 \fRChanging the \fB10.0.0.1\fR Entry to \fB10.0.0.2\fR -.sp -.LP -The following command changes the \fB10.0.0.1\fR entry to \fB10.0.0.2\fR, -making an entry in the \fBhosts\fR(4) table called \fBmyclient\fR: - -.sp -.in +2 -.nf -example# \fBpntadm -M 10.0.0.1 -n 10.0.0.2 -h myclient 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 5 \fRSetting the Client \fBID\fR as \fBASCII\fR -.sp -.LP -The following command sets the client \fBID\fR as \fBASCII\fR -\fBaruba.foo.com\fR for the \fBmyclient\fR entry: - -.sp -.in +2 -.nf -example# \fBpntadm -M myclient -i 'aruba.foo.com' -a 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 6 \fRDeleting the \fBmyclient\fREntry from the \fB10.0.0.0\fR Table -.sp -.LP -The following command deletes the \fBmyclient\fR (\fB10.0.0.2\fR) entry from -the \fB10.0.0.0\fR table: - -.sp -.in +2 -.nf -example# \fBpntadm -D myclient 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 7 \fRRemoving the Named DHCP Network Table -.sp -.LP -The following command removes the named \fBDHCP\fR network table in the NIS+ -directory specified: - -.sp -.in +2 -.nf -example# \fBpntadm -r SUNWnisplus -p Test.Nis.Plus. -R 10.0.0.0\fR -.fi -.in -2 -.sp - -.LP -\fBExample 8 \fRListing the Configured DHCP Network Tables -.sp -.LP -The following command lists the configured DHCP network tables: - -.sp -.in +2 -.nf -example# \fBpntadm -L\fR -192.168.0.0 -10.0.0.0 -.fi -.in -2 -.sp - -.LP -\fBExample 9 \fRExecuting \fBpntadm\fR Commands in Batch Mode -.sp -.LP -The following command runs a series of \fBpntadm\fR commands contained in a -batch file: - -.sp -.in +2 -.nf -example# \fBpntadm -B addclients\fR -.fi -.in -2 -.sp - -.SH EXIT STATUS -.sp -.ne 2 -.na -\fB\fB0\fR\fR -.ad -.RS 5n -Successful completion. -.RE - -.sp -.ne 2 -.na -\fB\fB1\fR\fR -.ad -.RS 5n -Object already exists. -.RE - -.sp -.ne 2 -.na -\fB\fB2\fR\fR -.ad -.RS 5n -Object does not exist. -.RE - -.sp -.ne 2 -.na -\fB\fB3\fR\fR -.ad -.RS 5n -Non-critical error. -.RE - -.sp -.ne 2 -.na -\fB\fB4\fR\fR -.ad -.RS 5n -Critical error. -.RE - -.SH FILES -.sp -.ne 2 -.na -\fB\fB/etc/inet/dhcpsvc.conf\fR\fR -.ad -.RS 26n - -.RE - -.sp -.ne 2 -.na -\fB\fB/etc/inet/hosts\fR\fR -.ad -.RS 26n - -.RE - -.SH ATTRIBUTES -.sp -.LP -See \fBattributes\fR(5) for descriptions of the following attributes: -.sp - -.sp -.TS -box; -c | c -l | l . -ATTRIBUTE TYPE ATTRIBUTE VALUE -_ -Interface Stability Evolving -.TE - -.SH SEE ALSO -.sp -.LP -\fBdhcpconfig\fR(1M), \fBdhcpmgr\fR(1M), \fBdhcp_network\fR(4), , -\fBdhcpsvc.conf\fR(4), \fBdhcptab\fR(4), \fBhosts\fR(4), \fBnetmasks\fR(4), -\fBnetworks\fR(4), \fBuser_attr\fR(4), \fBattributes\fR(5), \fBdhcp\fR(5), -\fBdhcp_modules\fR(5), \fBrbac\fR(5) -.sp -.LP -\fI\fR -.sp -.LP -\fI\fR -.sp -.LP -Alexander, S., and R. Droms, \fIDHCP Options and BOOTP Vendor Extensions\fR, -RFC 1533, Lachman Technology, Inc., Bucknell University, October 1993. -.sp -.LP -Droms, R., \fIInteroperation Between DHCP and BOOTP\fR, RFC 1534, Bucknell -University, October 1993. -.sp -.LP -Droms, R., \fIDynamic Host Configuration Protocol\fR, RFC 1541, Bucknell -University, October 1993. -.sp -.LP -Wimer, W., \fIClarifications and Extensions for the Bootstrap Protocol\fR, RFC -1542, Carnegie Mellon University, October 1993. |