Stops processes without changing their status flags in the BosConfig file
Synopsis
bos shutdown -server machine [-process server_process...] [-wait]
[{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine on which the indicated processes are to be stopped. The BOS Server on this machine executes the command. To run this command
using a privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the equivalent of running the command with the
-noauth option), specify the machine's host name or IP address.
-process server_process
Specifies each process to be stopped. If this option is omitted, the BOS Server stops all server processes other than itself on the server
machine. Refer to a process by the name assigned with the -process option of the bos create command; this name appears in the output of the bos status command.
-wait
Indicates that the command shell prompt is not to return until the shutdown is complete (until all processes actually stop running). If this option is omitted, the prompt
returns almost immediately, even if all of the processes are not yet stopped.
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. The command fails if you use this option and DFS
authorization checking is not disabled on the machine specified by -server. If you use this option, do not use the -localauth option.
-localauth
Directs bos to use the DFS server principal name of the machine on which the command is issued as the identity of the issuer. Use this option only if the
command is issued from a DFS server machine (a machine that has a DFS server principal in the local Registry Database). You must be logged into the server machine as root for this option to
work. If you use this option, do not use the -noauth option.
-help
Prints the online help for this command. All other valid options specified with this option are ignored.
Description
The bos shutdown command instructs the BOS Server running on the server machine specified by -server to stop either all processes (except itself)
running on the machine or only the processes specified by -process. The command does not change a process's status flag in the BosConfig file, only in the BOS Server's
memory state.
Processes stopped with this command do not run again until they are started using the bos start, bos startup, or bos restart commands, or until the BOS Server itself restarts.
Privilege Required
The issuer must be listed in the admin.bos file on the machine specified by -server.
Examples
The following command instructs the BOS Server running on fs3 to stop running all processes except itself:
$ bos shutdown -s /.../abc.com/hosts/fs3
Related Information
Commands: bos create(8dfs)