Displays the statuses of server processes on a server machine
Synopsis
bos status -server machine [-process server_process...] [-long]
[{-noauth | -localauth}] [-help]
Options
-server machine
Names the server machine about whose processes status information is to be displayed. The BOS Server on this machine executes the command. Specify
the machine's DCE path name, its host name, or its IP address.
-process server_process
Specifies each process whose status is to be displayed; refer to a process by the name assigned with the -process option of the
bos create command. If this option is omitted, the statuses of all of the processes on the specified server are listed.
-long
Directs the BOS Server to provide more detailed information about the specified processes.
-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. 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 status command lists status information about the processes on the server machine specified by the -server option. Use the
-process option to indicate the specific processes about which information is to be displayed, or omit the option to display information about all the processes on the server machine. The
command also displays appropriate messages if DFS authorization checking is disabled on the machine or if the machine's dcelocal directory or a directory or file beneath it has inappropriate
protections.
Use the -long option to display more information about each specified process. The additional information can be used to determine the role of a server machine in a domain. (See Part 1 of the OSF DCE DFS Administration Guide and Reference for instructions on using this command to determine the role of a server machine.)
Privilege Required
No privileges are required.
Output
The command first displays the following line if DFS authorization checking is disabled on the machine (it does not display the line if DFS authorization checking is
enabled):
Bosserver reports machine is not checking authorization.
It then displays the following line if the BOS Server finds that the dcelocal directory or a directory or file under it on the machine has protections that the BOS Server believes are inappropriate:
Bosserver reports inappropriate access on server directories.
The message can indicate, for example, that users who should not be able to write to the dcelocal directory and its subdirectories have write access. The BOS Server displays the message if the UNIX mode bits on the following objects do not enforce the indicated protections. Provided the mode bits do not violate the specific restrictions cited in the list, a directory or file can grant more permissions than those shown in the list, but it should not grant fewer.
dcelocal
At least 755, and other cannot have write access
dcelocal/bin
At least 755, and other cannot have write access
dcelocal/var
At least 755, and other cannot have write access
dcelocal/var/dfs
At least 701, and other cannot have write access
dcelocal/var/dfs/adm
At least 755, and other cannot have write access
dcelocal/var/dfs/admin.bos
At least 600, and other cannot have write or execute access
The BOS Server also displays the message if all of these objects are not owned by root. The BOS Server displays the message only as a courtesy to the user. It does nothing to change the protections on these objects, nor does it fail if these protections are violated.
Note: The protections just described are the default protections enforced by the BOS Server. Your vendor can modify the required owner of the indicated directories and the permissions those directories must have. Refer to your vendor's documentation to determine the protections that apply for your version of DFS.
The command then displays a separate entry for each specified process. The first line of an entry shows the current status of the process. The possible statuses for any process include the following:
currently running normally
For a simple process, this means it is currently running; for a cron process, this means it is scheduled to run.
temporarily enabled
The status flag for the process in the dcelocal/var/dfs/BosConfig file is NotRun, but the process has been enabled with the
bos startup or bos restart command.
temporarily disabled
Either the bos shutdown command was used to stop the process, or the BOS Server quit trying to restart the process, in which case the message
stopped for too many errors also appears.
disabled
The status flag for the process in the BosConfig file is NotRun, and the process has not been enabled.
has core file
The process failed or produced a core file at some time. This message can appear with any of the other messages. Core files are stored in
dcelocal/var/dfs/adm. The name of the core file indicates the process that failed (for example, core.ftserver).
The output for a cron process includes an auxiliary status message that reports when the command is next scheduled to execute.
The command displays the following additional information when the -long option is used:
· The process type (simple or cron).
· How many proc starts occurred (proc starts occur when the process is started or restarted by the current BOS Server).
· The time of the last proc start.
· The exit time and error exit time when the process last failed. This appears only if the process failed while the BOS Server was running. (Provided the BOS Server was running both when the process was started and when it failed, the BOS Server can provide this information for any process that has an entry in the BosConfig file.)
· The command and its options used by the BOS Server to start the process.
Examples
The following command displays the statuses of all server processes on the File Server machine named fs4:
$ bos status /.../abc.com/hosts/fs4
Instance ftserver, currently running normally.
Instance repserver, currently running normally.
If the -long option is included with the command, the following additional information is displayed:
Instance ftserver, (type is simple) currently running normally.
Process last started at Fri Nov 22 05:36:02 1991 (1 proc starts)
Parameter 1 is `dcelocal/bin/ftserver'
Instance repserver, (type is simple) currently running normally.
Process last started at Fri Nov 22 05:36:48 1991 (1 proc starts)
Parameter 1 is `dcelocal/bin/repserver'
Related Information
Commands: bos create(8dfs)
Files: BosConfig(4dfs)