Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
pntadm(1M)		System Administration Commands		    pntadm(1M)

NAME
       pntadm -	DHCP network table management utility

SYNOPSIS
       pntadm -C [-r resource] [-p path] [-u uninterpreted] network

       pntadm  -A name_IP_address  [-c comment]	[-e mm/dd/yyyy]	[-f num	| key-
       words]  [ -h client_hostname] [ -i [-a] client_ID]  [  -m  [-y]	macro]
       [-s server] [-r resource] [-p path] [-u uninterpreted] network

       pntadm  -M name_IP_address  [-c comment]	[-e mm/dd/yyyy]	[-f num	| key-
       words]  [ -h client_hostname] [ -i [-a] client  ID] [  -m  [-y]	macro]
       [-n new_client_IP_address]  [-s server] [-r resource] [-p path] [-u un-
       interpreted] network

       pntadm -D name_IP_address  [-y]	[-r resource]  [-p path]  [-u uninter-
       preted] network

       pntadm -P [-v] [-x] [-r resource] [-p path] [-u uninterpreted] network

       pntadm -R [-r resource] [-p path] [-u uninterpreted] network

       pntadm -L [-r resource] [-p path] [-u uninterpreted]

       pntadm -B [-v] [batchfile]

DESCRIPTION
       The  pntadm  command  is	 used to manage	the Dynamic Host Configuration
       Protocol	(DHCP) network tables. It is used to add and  remove  networks
       under  DHCP  management,	 and add, delete, or modify IP address records
       within network tables, or to view tables. For a description of the for-
       mat of DHCP network tables, see dhcp_network(4).

       pntadm  can  be run as root or by other users assigned to the DHCP Man-
       agement profile.	See rbac(5) and	user_attr(4).

       If the networks you want	to add are subnetted, you need to  update  the
       netmasks(4) table.

       One  of	the  following options (function flags)	must be	specified with
       the pntadm command: -A, -B, -C, -D, -L, -M, -P, or-R.

OPTIONS
       The following options are supported:

	      -A name_IP_address
		    Add	a client entry with hostname  or  client  IP  address,
		    name_IP_address, to	the named DHCP network table.

		    The	following sub-options are optional:

		    -c comment
			  Comment text.	The default is NULL.

		    -e mm/dd/yyyy
			  Absolute lease. The default is 0.

		    -f num | keywords
			  Flag value. The default is 00.

			  The  flag  (-f)  option can be specified either as a
			  single number	denoting the intended flag  value,  or
			  as  a	series of the following	keywords, combined us-
			  ing the plus (+) symbol:

			  DYNAMIC or 00
				Server manager's assignment.

			  PERMANENT or 01
				Lease on entry is permanent.

			  MANUAL or 02
				Administrator managed assignment.

			  UNUSABLE or 04
				Entry is not valid.

			  BOOTP	or 08
				Entry reserved for BOOTP clients.

			  For a	more detailed description of the flag  values,
			  see dhcp_network(4).

		    -h client_hostname
			  Client hostname. The default is NULL.

			  When	the  -h	 option	 is  used  in  this  mode, the
			  client_hostname is added to the hosts	 table	within
			  the  resource	 used  for  storing host names (files,
			  NIS+	or  DNS).  The	command	 will  fail  if	  this
			  client_hostname  is already present in the hosts ta-
			  ble.

		    -i client_ID [-a]
			  Client identifier [-a]. The default is 00.

			  The -i option	modified with -a  specifies  that  the
			  client identifier is in ASCII	format,	and thus needs
			  to be	converted to hexadecimal format	before	inser-
			  tion into the	table.

		    -m macro [-y]
			  Macro	name. Default is UNKNOWN.

			  The  -m  option  modified with -y verifies the exis-
			  tence	of the named macro in the  dhcptab  table  be-
			  fore adding the entry.

		    -s server
			  Server  IP  or  name.	 Default is system name	(uname
			  -n).

	      -B    Activate batch mode. pntadm	will read from	the  specified
		    file  or  from  standard input a series of pntadm commands
		    and	execute	them within the	same process. Processing  many
		    pntadm commands using this method is much faster than run-
		    ning an executable batchfile itself. Batch mode is	recom-
		    mended for using pntadm in scripts.

		    The	following sub-option is	optional:

		    -v	  Display commands to standard output as they are pro-
			  cessed.

	      -C    Create the DHCP network table for the network specified by
		    network.  See  OPERANDS.  For details, see dhcp_network(4)
		    and	networks(4).

	      -D  name_IP_address
		    Delete the specified client	entry with hostname or	client
		    IP address,	name_IP_address, in the	named DHCP network ta-
		    ble. (See dhcp_network(4).)

		    The	following sub-option is	optional:

		    -y	  Remove associated host table entry.  The  -y	option
			  requests  that  all hostnames	associated with	the IP
			  address in the hosts table in	the  resource  be  re-
			  moved.

	      -L    List the DHCP network tables presently configured, one per
		    line, on standard output. If none are found, no output  is
		    printed and	an exit	status of 0 is returned.

	      -M  name_IP_address
		    Modify  the	specified client entry with hostname or	client
		    IP address,	name_IP_address, in the	named DHCP network ta-
		    ble.  See dhcp_network(4). The default for the sub-options
		    is what they currently are set to.

		    The	following sub-options are optional.

		    -c comment
			  New comment text.

		    -e mm/dd/yy
			  New absolute lease expiration	date. Time defaults to
			  12:00	AM of the day specified.

		    -f num | keyboard
			  New  flag  value, see	explanation  following the de-
			  scription of the -A option.

		    -h host_name
			  New client hostname.

			  The -h option	allows you to change the current host-
			  name	associated with	the IP address or to add a new
			  hostname to the hosts	table if an  entry  associated
			  with this IP address does not	exist.

		    -i client_ID
			  New client identifier	[-a].

		    -m macro [-y]
			  Macro	name defined in	dhcptab.

		    -n	new_client_IP_address
			  New IP address.

		    -s server
			  New server IP	or name.

		     For more detailed description of the sub-options and flag
		    values, see	dhcp_network(4).

	      -P    Display the	named DHCP network table. See dhcp_network(4).

		    The	following sub-options are optional:

		    -v	  Display lease	time in	full verbose format.

		    -x	  Display lease	time in	raw format.

	      -p path
		    Override the dhcpsvc.conf(4) configuration value for  data
		    store resource path, path See dhcpsvc.conf(4)

	      -R    Remove the named DHCP network table. See dhcp_network(4).

	      -r data_store_resource
		    Override  the  /etc/inet/dhcpsvc.conf  configuration value
		    for	RESOURCE= with the data_store_resource specified.  See
		    the	 dhcpsvc.conf(4) man page for more details on resource
		    type, and the Solaris DHCP Service Developer's  Guide  for
		    more  information  about  adding  support  for  other data
		    stores.

	      -u uninterpreted
		    Data which will be ignored by pntadm, 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.

OPERANDS
       The following operand is	supported:

       network
	     The network address or network name which corresponds to the dhcp
	     network table. See	dhcp_network(4).

EXAMPLES
       Example 1: Creating a Table for the 10.0.0.0 DHCP Network

       The  following  command	creates	a table	for the	10.0.0.0 (subnetted to
       class C)	 DHCP network table. Note that if you have an alias  for  this
       network	in  your networks(4) table, you	can use	that value rather than
       the dotted Internet Address notation.

       example#	pntadm -C 10.0.0.0

       Example 2: Adding an Entry to the 10.0.0.0 Table

       The following command adds an entry to the 10.0.0.0 table in the	 files
       resource	in the /var/mydhcp directory:

       example#	pntadm -r SUNWfiles -p /var/mydhcp -A 10.0.0.1 10.0.0.0

       Example 3: Modifying the	10.0.0.1 Entry of the 10.0.0.0 Table

       The  following  command modifies	the 10.0.0.1 entry of the 10.0.0.0 ta-
       ble, changing the macro name to Green, setting the flags	field to  MAN-
       UAL and PERMANENT:

       example#	pntadm -M 10.0.0.1 -m Green -f 'PERMANENT + MANUAL' 10.0.0.0

       Example 4: Changing the 10.0.0.1	Entry to 10.0.0.2

       The following command changes the 10.0.0.1 entry	to 10.0.0.2, making an
       entry in	the hosts(4) table called myclient:

       example#	pntadm -M 10.0.0.1 -n 10.0.0.2 -h myclient 10.0.0.0

       Example 5: Setting the Client ID	as ASCII

       The following command sets the client ID	as ASCII aruba.foo.com for the
       myclient	entry:

       example#	pntadm -M myclient -i 'aruba.foo.com' -a 10.0.0.0

       Example 6: Deleting the myclientEntry from the 10.0.0.0 Table

       The  following  command	deletes	the myclient (10.0.0.2)	entry from the
       10.0.0.0	table:

       example#	pntadm -D myclient 10.0.0.0

       Example 7: Removing the Named DHCP Network Table

       The following command removes the named DHCP network table in the  NIS+
       directory specified:

       example#	pntadm -r SUNWnisplus -p Test.Nis.Plus.	-R 10.0.0.0

       Example 8: Listing the Configured DHCP Network Tables

       The following command lists the configured DHCP network tables:

       example#	pntadm -L
       192.168.0.0
       10.0.0.0

       Example 9: Executing pntadm Commands in Batch Mode

       The  following  command runs a series of	pntadm commands	contained in a
       batch file:

       example#	pntadm -B addclients

EXIT STATUS
       0     Successful	completion.

       1     Object already exists.

       2     Object does not exist.

       3     Non-critical error.

       4     Critical error.

FILES
       /etc/inet/dhcpsvc.conf

       /etc/inet/hosts

ATTRIBUTES
       See attributes(5) for descriptions of the following attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE	TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWdhcsu			   |
       +-----------------------------+-----------------------------+
       |Interface Stability	     |Evolving			   |
       +-----------------------------+-----------------------------+

SEE ALSO
       dhcpconfig(1M),	dhcpmgr(1M),   dhcp_network(4),	  ,   dhcpsvc.conf(4),
       dhcptab(4),   hosts(4),	netmasks(4),  networks(4),  user_attr(4),  at-
       tributes(5), dhcp(5), dhcp_modules(5), rbac(5)

       Solaris DHCP Service Developer's	Guide

       System Administration Guide: IP Services

       Alexander, S., and R. Droms, DHCP Options and BOOTP Vendor  Extensions,
       RFC 1533, Lachman Technology, Inc., Bucknell University,	October	1993.

       Droms,  R.,  Interoperation  Between DHCP and BOOTP, RFC	1534, Bucknell
       University, October 1993.

       Droms, R., Dynamic Host Configuration Protocol, RFC 1541, Bucknell Uni-
       versity,	October	1993.

       Wimer,  W.,  Clarifications  and	Extensions for the Bootstrap Protocol,
       RFC 1542, Carnegie Mellon University, October 1993.

SunOS 5.9			  13 Mar 2001			    pntadm(1M)

NAME | SYNOPSIS | DESCRIPTION | OPTIONS | OPERANDS | EXAMPLES | EXIT STATUS | FILES | ATTRIBUTES | SEE ALSO

Want to link to this manual page? Use this URL:
<https://www.freebsd.org/cgi/man.cgi?query=pntadm&sektion=1m&manpath=SunOS+5.9>

home | help