NAME

bos - suite of commands for contacting the AFS Basic OverSeer (BOS) Server. 

SYNOPSIS

bos <option>

Each of the the following operation codes is a valid <option> and has its own set of associated arguments.  See the "OPTIONS" section below for syntax definitions. 

addhost - add host to cell dbase
addkey - add keys to key dbase (kvno 999 is bcrypt)
adduser - add users to super-user list
apropos - search by help text
create - create a new server instance
delete - delete a server instance
exec - execute shell command on server
getdate - get dates for programs
getrestart - get restart times
help - get help on commands
install - install program
listhosts - get cell host list
listkeys - list keys
listusers - list super-users
prune - prune server files
removehost - remove host from cell dbase
removekey - remove keys from key dbase
removeuser - remove users from super-user list
restart - restart all processes
salvage - salvage partition or volumes
setauth - set authentication required flag
setcellname - set cell name
setrestart - set restart times
shutdown - shutdown all processes
start - start running a server
startup - start all processes
status - show server instance status
stop - halt a server instance
uninstall - uninstall program

DESCRIPTION

The commands in the bos suite are an interface to the Basic OverSeer (BOS) Server, an AFS server process that aids system administrators and operators in the efficient administration of AFS.  There are bos commands that allow system administrators to start and stop server processes at will, check on server process status, install new binaries for server processes, and maintain files of system configuration information. 

OPTIONS

addhost - add host to cell dbase
syntax: bos addhost -server <machine name>  -host <host name>+ [-cell <cell name>] [-noauth]  [-help]

addkey - add keys to key dbase (kvno 999 is bcrypt)
syntax: bos addkey  -server <machine name>  -key <key>   -kvno <key version number> [-cell <cell name>]  [-noauth]  [-help]

adduser - add users to super-user list
syntax: bos adduser  -server <machine name>  -user <user names>+ [-cell <cell name>]  [-noauth]  [-help]

apropos - search by help text
syntax: bos apropos -topic <help string>  [-help]

create - create a new server instance
syntax: bos create  -server <machine name>  -instance <server process name> -type <server type>  -cmd <command lines>+ [-cell <cell name>] [-noauth]  [-help]

delete - delete a server instance
syntax: bos delete  -server <machine name>  -instance <server process name>+  [-cell <cell name>]  [-noauth]  [-help]

exec - execute shell command on server
syntax: bos exec  -server <machine name>  -cmd <command to execute>  [-cell <cell name>]  [-noauth]  [-help]

getdate - get dates for programs
syntax: bos getdate  -server <machine name>  -file <files to check>+  [-dir <destination dir>]  [-cell <cell name>]  [-noauth]  [-help]

getrestart - get restart times
syntax: bos getrestart  -server <machine name>  [-cell <cell name>]  [-noauth]  [-help]

help - get help on commands
syntax: bos help  [-topic <help string>+]  [-help]

install - install program
syntax: bos install  -server <machine name>  -file <files to install>+  [-dir <destination dir>]  [-cell <cell name>]  [-noauth]  [-help]

listhosts - get cell host list
syntax: bos listhosts  -server <machine name>  [-cell <cell name>]  [-noauth]  [-help]
alias: bos getcell

listkeys - list keys
syntax: bos listkeys  -server <machine name>  [-cell <cell name>]  [-noauth]  [-help]

listusers - list super-users
syntax: bos listusers  -server <machine name>  [-cell <cell name>]  [-noauth]  [-help]

prune - prune server files
syntax: bos prune  -server <machine name>  [-bak]  [-old]  [-core]  [-all]  [-cell <cell name>]  [-noauth]  [-help]

removehost - remove host from cell dbase
syntax: bos removehost  -server <machine name>  -host <host name>+  [-cell <cell name>]  [-noauth]  [-help]

removekey - remove keys from key dbase
syntax: bos removekey -server <machine name>  -kvno <key version number>+  [-cell <cell name>]  [-noauth]  [-help]

removeuser - remove users from super-user list
syntax: bos removeuser  -server <machine name>  -user <user names>+  [-cell <cell name>]  [-noauth]  [-help]

restart - restart all processes
syntax: bos restart  -server <machine name>  [-instance <instances>+]  [-bosserver]  [-cell <cell name>]  [-noauth]  [-help]

salvage - salvage partition or volumes
syntax: bos salvage  -server <machine name>  [-partition <salvage partition>] [-volume <salvage volume number>] [-file <salvage log output file>]  [-all] [-cell <cell name>] [-noauth]  [-help]

setauth - set authentication required flag
syntax: bos setauth  -server <machine name>  -authrequired <on or off:authentication required for admin requests>  [-cell <cell name>] [-noauth]  [-help]

setcellname - set cell name
syntax: bos setcellname  -server <machine name>  -name <cell name>  [-cell <cell name>]  [-noauth]  [-help]

setrestart - set restart times
syntax: bos setrestart  -server <machine name>  -time <time to restart server> [-general]  [-newbinary]  [-cell <cell name>]  [-noauth]  [-help]

shutdown - shutdown all processes
syntax: bos shutdown  -server <machine name>  [-instance <instances>+] [-wait]  [-cell <cell name>]  [-noauth]  [-help]

start - start running a server
syntax: bos start  -server <machine name>  -instance <server process name>+  [-cell <cell name>]  [-noauth]  [-help]

startup - start all processes
syntax: bos startup  -server <machine name>  [-instance <instances>+]  [-cell <cell name>]  [-noauth]  [-help]

status - show server instance status
syntax: bos status  -server <machine name>  [-instance <server process name>+]  [-long]  [-cell <cell name>]  [-noauth]  [-help]

stop - halt a server instance
syntax: bos stop  -server <machine name>  -instance <server process name>+  [-wait]  [-cell <cell name>]  [-noauth]  [-help]

uninstall - uninstall program
syntax: bos uninstall  -server <machine name>  -file <files to uninstall>+  [-dir <destination dir>]  [-cell <cell name>]  [-noauth]  [-help]
 
 
 

  —  Last change: 30 April 1990