NAME

addhost − Add a new host to the system

SYNOPSIS

addhost [options] [−n name −i internet −a netAddress −m machineType −s swapDir]

OPTIONS

−a addressThe −a flag is required, and is used to set the local network address of the host.  Usually address is an Ethernet address, and is of the form "a:b:c:d:e:f". 
 

−d domainUsed to set the local domain.  The domain string is appended to the name provided by the −n flag to produce the full name of the machine.  The default is to parse the domain name from the spritehosts file.  If the file is empty then the −d flag must be given. 
 

−h, −help, −?These options cause a help listing to be printed. 
 

−i internetInternet is the internet address of the host.  The address is in the form "a.b.c.d".  This flag is required. 
 

−I spriteIDThe −I flag is used to assign a Sprite ID to the host.  Care must be taken that spriteID does not conflict with the id of an existing host.  If the −I flag is omitted addhost will use a Sprite ID that is one greater than the largest id found in the spritehosts file. 
 

−m machineType
This flag sets the machine type of the host to be added. This flag must be used. Supported machine types are sun3, sun4, sun4c, and ds3100. 
 

−n nameName is the name of the host.  This flag is required. 
 

−s swapDirThe −s defines swapDir to be the directory in which to create the swap directory for the new host.  The default is /swap.  If a different directory is specified then a link will be make in /swap. 
 

−t netTypeThe −t flag is used to set the type of the network associated with the host.  The default is ether, indicating that the host is connected to the system via an Ethernet, and the the argument to the −a flag is the Ethernet address of the host.  The only other supported value for the netType argument is inet, indicating that a gateway exists between the host and the root file server.  In this case the argument to the −a flag is the Ethernet address of the gateway machine. 
 

−RAddhost will not allow a host to be added if the name of the new host conflicts with the name of an existing host.  If the −R flag is specified than the existing host information is replaced with the information for the new host.  If you are upgrading a machine from one machine type to another but retaining the name then the −R flag should be used. 
 

−r rootThe −r flag is used to specify that the root of the Sprite filesystem is something other than "/". 
 

−o ownerUsed to specify the owner or primary user of the machine.  This information is added to /sprite/admin/hosts. 
 

−l locationUsed to specify the location of the machine.  This information is added to /sprite/admin/hosts. 
 

−T machine description
The −T flag is used to specify the full machine description.  Examples might be "sun3/75" or "sun4/260".  This information is added to /sprite/admin/hosts. 
 
 
 

DESCRIPTION

The addhost command is used to add a new host to the system.  It should only be run by the super-user (root).  Invoking addhost without any options will cause it to run in an interactive mode where you will be prompted for the host name, type, etc.  These parameters can also be set via options on the command line.  The use of any options causes addhost to not run interactively.  In this case a minimum set of options must be used.  The −a, −i, −n, −m, and −s flags must be used to indicate the local address, Internet address, host name, host machine type, and swap directory, respectively.  The options are described in more detail in the section above. 

As the addhost script runs it will print out information on the actions it is taking.  Once the script is complete you should look in /sprite/admin/howto/addNewHost for any remaining steps in the installation procedure. 
 

FILES

The following files are edited by addhost: /etc/spritehosts, /etc/hosts.equiv, /sprite/admin/hosts
 

KEYWORDS

spritehosts, new, host, hosts, hosts.equiv
 

Sprite version 1.0  —  February 13, 1990