.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" .\" Accent mark definitions (@(#)ms.acc 1.5 88/02/08 SMI; from UCB 4.2). .\" Fear. Run. Save yourself. No user-serviceable parts. . \" fudge factors for nroff and troff .if n \{\ . ds #H 0 . ds #V .8m . ds #F .3m . ds #[ \f1 . ds #] \fP .\} .if t \{\ . ds #H ((1u-(\\\\n(.fu%2u))*.13m) . ds #V .6m . ds #F 0 . ds #[ \& . ds #] \& .\} . \" simple accents for nroff and troff .if n \{\ . ds ' \& . ds ` \& . ds ^ \& . ds , \& . ds ~ ~ . ds / .\} .if t \{\ . ds ' \\k:\h'-(\\n(.wu*8/10-\*(#H)'\'\h"|\\n:u" . ds ` \\k:\h'-(\\n(.wu*8/10-\*(#H)'\`\h'|\\n:u' . ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'^\h'|\\n:u' . ds , \\k:\h'-(\\n(.wu*8/10)',\h'|\\n:u' . ds ~ \\k:\h'-(\\n(.wu-\*(#H-.1m)'~\h'|\\n:u' . ds / \\k:\h'-(\\n(.wu*8/10-\*(#H)'\z\(sl\h'|\\n:u' .\} . \" troff and (daisy-wheel) nroff accents .ds : \\k:\h'-(\\n(.wu*8/10-\*(#H+.1m+\*(#F)'\v'-\*(#V'\z.\h'.2m+\*(#F'.\h'|\\n:u'\v'\*(#V' .ds 8 \h'\*(#H'\(*b\h'-\*(#H' .ds o \\k:\h'-(\\n(.wu+\w'\(de'u-\*(#H)/2u'\v'-.3n'\*(#[\z\(de\v'.3n'\h'|\\n:u'\*(#] .ds d- \h'\*(#H'\(pd\h'-\w'~'u'\v'-.25m'\f2\(hy\fP\v'.25m'\h'-\*(#H' .ds D- D\\k:\h'-\w'D'u'\v'-.11m'\z\(hy\v'.11m'\h'|\\n:u' .ds th \*(#[\v'.3m'\s+1I\s-1\v'-.3m'\h'-(\w'I'u*2/3)'\s-1o\s+1\*(#] .ds Th \*(#[\s+2I\s-2\h'-\w'I'u*3/5'\v'-.3m'o\v'.3m'\*(#] .ds ae a\h'-(\w'a'u*4/10)'e .ds Ae A\h'-(\w'A'u*4/10)'E . \" corrections for vroff .if v .ds ~ \\k:\h'-(\\n(.wu*9/10-\*(#H)'\s-2\u~\d\s+2\h'|\\n:u' .if v .ds ^ \\k:\h'-(\\n(.wu*10/11-\*(#H)'\v'-.4m'^\v'.4m'\h'|\\n:u' . \" for low resolution devices (crt and lpr) .if \n(.H>23 .if \n(.V>19 \ \{\ . ds : e . ds 8 ss . ds o a . ds d- d\h'-1'\(ga . ds D- D\h'-1'\(hy . ds th \o'bp' . ds Th \o'LP' . ds ae ae . ds Ae AE .\} .rm #[ #] #H #V #F C .\" ======================================================================== .\" .IX Title "BOS_STATUS 8" .TH BOS_STATUS 8 "2023-12-24" "OpenAFS" "AFS Command Reference" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" bos_status \- Displays the status of server processes .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBbos\ status\ \-server\fR\ <\fImachine\ name\fR> [\-instance <\fIserver process name\fR>+] [\fB\-long\fR] [\fB\-cell\fR\ <\fIcell\ name\fR>] [\fB\-noauth\fR] [\fB\-localauth\fR] [\fB\-help\fR] .PP \&\fBbos\ stat\ \-s\fR\ <\fImachine\ name\fR> [\-i <\fIserver process name\fR>+] [\fB\-lon\fR] [\fB\-c\fR\ <\fIcell\ name\fR>] [\fB\-n\fR] [\fB\-loc\fR] [\fB\-h\fR] .SH "DESCRIPTION" .IX Header "DESCRIPTION" The bos status command reports the status of processes on the server machine named by the \fB\-server\fR argument, either .IP "\(bu" 4 All of the \s-1AFS\s0 server processes listed in the \&\fI/etc/openafs/BosConfig\fR file .IP "\(bu" 4 Only these processes named by the \-instance argument .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-server\fR <\fImachine name\fR>" 4 .IX Item "-server " Indicates the server machine for which to report server process status. Identify the machine by \s-1IP\s0 address or its host name (either fully-qualified or abbreviated unambiguously). For details, see \fBbos\fR\|(8). .IP "\-instance" 4 .IX Item "-instance" Names each process for which to report status. Use the process name assigned with the \fB\-instance\fR argument to the \fBbos\fR command. The output from the \fBbos status\fR command lists the names. .IP "\-long" 4 .IX Item "-long" Produces more detailed status information. .IP "\fB\-cell\fR <\fIcell name\fR>" 4 .IX Item "-cell " Names the cell in which to run the command. Do not combine this argument with the \fB\-localauth\fR flag. For more details, see \fBbos\fR\|(8). .IP "\fB\-noauth\fR" 4 .IX Item "-noauth" Assigns the unprivileged identity \f(CW\*(C`anonymous\*(C'\fR to the issuer. Do not combine this flag with the \fB\-localauth\fR flag. For more details, see \fBbos\fR\|(8). .IP "\fB\-localauth\fR" 4 .IX Item "-localauth" Constructs a server ticket using a key from the local \&\fI/etc/openafs/server/KeyFile\fR or \fI/etc/openafs/server/KeyFileExt\fR file. The \fBbos\fR command interpreter presents the ticket to the \s-1BOS\s0 Server during mutual authentication. Do not combine this flag with the \fB\-cell\fR or \&\fB\-noauth\fR options. For more details, see \fBbos\fR\|(8). .IP "\fB\-help\fR" 4 .IX Item "-help" Prints the online help for this command. All other valid options are ignored. .SH "OUTPUT" .IX Header "OUTPUT" The output for a process includes at least one line, which reports one of the following as the process's current status: .IP "\(bu" 4 \&\f(CW\*(C`currently running normally\*(C'\fR. The process's status flag in the \fBBosConfig\fR file is \f(CW\*(C`Run\*(C'\fR. For \&\fBcron\fR entries, this message indicates only that the command is scheduled to run, not necessarily that it was executing when the \fBbos status\fR command was issued. .IP "\(bu" 4 \&\f(CW\*(C`disabled\*(C'\fR. The process is not running, and its \&\fBBosConfig\fR status flag is \f(CW\*(C`NotRun\*(C'\fR. .IP "\(bu" 4 \&\f(CW\*(C`temporarily disabled\*(C'\fR. The process is not running although its status flag in the \fBBosConfig\fR file is \&\f(CW\*(C`Run\*(C'\fR. Either an administrator used the \fBbos shutdown\fR command to stop it, or the .IP "\(bu" 4 \&\s-1BOS\s0 Server stopped trying to restart it after numerous failed attempts. In the second case, the auxiliary message is \f(CW\*(C`stopped for too many errors\*(C'\fR. .IP "\(bu" 4 \&\f(CW\*(C`temporarily enabled\*(C'\fR. The process is running although its status flag in the \fBBosConfig\fR file is \f(CW\*(C`NotRun\*(C'\fR. An administrator has used the \fBbos startup\fR command to start it. .PP If one of the following special circumstances applies to the process, the indicated message appears in its entry: .IP "\(bu" 4 \&\f(CW\*(C`has core file\*(C'\fR. The process failed and created a core file in the \fI/var/log/openafs\fR directory. If the \s-1BOS\s0 Server was able to restart the process after the failure, the primary status is \&\f(CW\*(C`currently running normally\*(C'\fR. .IP "\(bu" 4 \&\f(CW\*(C`stopped for too many errors\*(C'\fR. The reason for the primary status \f(CW\*(C`temporarily disabled\*(C'\fR is that the \s-1BOS\s0 Server's attempts to restart the process all failed. .PP The entry for the fs process always includes a second line to report the process's \f(CW\*(C`Auxiliary status\*(C'\fR, which is one of the following: .IP "\(bu" 4 \&\f(CW\*(C`file server running\*(C'\fR. The File Server and Volume Server components of the File Server process are running normally. .IP "\(bu" 4 \&\f(CW\*(C`salvaging file system\*(C'\fR. The Salvager is running, so the File Server and Volume Server are temporarily disabled. The \s-1BOS\s0 Server restarts them as soon as the Salvager is finished. .PP The entry for a cron process includes an \f(CW\*(C`Auxiliary status\*(C'\fR that reports when the command will next execute. .PP If the \-long flag is used, each entry includes the following additional information: .IP "\(bu" 4 The process's type (\f(CW\*(C`simple\*(C'\fR, \f(CW\*(C`fs\*(C'\fR, or \&\f(CW\*(C`cron\*(C'\fR). .IP "\(bu" 4 The day and time the process last started or restarted. .IP "\(bu" 4 The number of \f(CW\*(C`proc starts\*(C'\fR, which is how many times the \s-1BOS\s0 Server has started or restarted the process since it started itself. .IP "\(bu" 4 The \f(CW\*(C`Last exit\*(C'\fR time when the process (or one of the component processes in the \fBfs\fR process) last terminated. This line does not appear if the process has not terminated since the \s-1BOS\s0 Server started. .IP "\(bu" 4 The \f(CW\*(C`Last error exit\*(C'\fR time when the process (or one of the component processes in the \fBfs\fR process) last failed due to an error. A further explanation such as \f(CW\*(C`due to shutdown request\*(C'\fR sometimes appears. This line does not appear if the process has not failed since the \s-1BOS\s0 Server started. .IP "\(bu" 4 Each command that the \s-1BOS\s0 Server invokes to start the process, as specified by the \fB\-cmd\fR argument to the \fBbos create\fR command. .IP "\(bu" 4 The pathname of the notifier program that the \s-1BOS\s0 Server invokes when the process terminates (if any), as specified by the \fB\-notifier\fR argument to the \fBbos create\fR command. .PP If the \-long flag is provided and the \s-1BOS\s0 Server discovers that the mode bits on files and subdirectories in the local \fI/usr/afs\fR directory differ from the expected values, it prints the following warning message: .PP .Vb 1 \& Bosserver reports inappropriate access on server directories .Ve .PP The following chart summarizes the expected mode bit settings. A question mark indicates that the \s-1BOS\s0 Server does not check that bit. .SH "EXAMPLES" .IX Header "EXAMPLES" The following example command displays the status of processes on the machine \fBfs3.example.com\fR: .PP .Vb 8 \& % bos status fs3.example.com \& Instance buserver, currently running normally. \& Instance kaserver, currently running normally. \& Instance ptserver, currently running normally. \& Instance vlserver, currently running normally. \& Instance fs, has core file, currently running normally. \& Auxiliary status is: file server running. \& Instance upserver, currently running normally. .Ve .PP The following example command displays a detailed status report for the \&\fBfs\fR and \fBptserver\fR processes on the machine \&\fBfs1.example.com\fR. .PP .Vb 10 \& % bos status \-server fs1.example.com \-instance fs ptserver \-long \& Instance fs, (type is fs), currently running normally. \& Auxiliary status is: file server running. \& Process last started at Wed Jan 7 5:34:49 1998 (3 proc starts) \& Last exit at Wed Jan 7 5:34:49 1998 \& Last error exit at Wed Jan 7 5:34:49 1998, due to shutdown \& request \& Command 1 is \*(Aq/usr/lib/openafs/fileserver\*(Aq \& Command 2 is \*(Aq/usr/lib/openafs/volserver\*(Aq \& Command 3 is \*(Aq/usr/lib/openafs/salvager\*(Aq \& Instance ptserver, (type is simple) currently running normally. \& Process last started at Tue Jan 6 8:29:19 1998 (1 proc starts) \& Command 1 is \*(Aq/usr/lib/openafs/ptserver\*(Aq .Ve .SH "PRIVILEGE REQUIRED" .IX Header "PRIVILEGE REQUIRED" None .SH "SEE ALSO" .IX Header "SEE ALSO" \&\fBBosConfig\fR\|(5), \&\fBKeyFile\fR\|(5), \&\fBKeyFileExt\fR\|(5), \&\fBbos\fR\|(8), \&\fBbos_create\fR\|(8), \&\fBbos_shutdown\fR\|(8), \&\fBbos_startup\fR\|(8), \&\fBbos_status\fR\|(8) .SH "COPYRIGHT" .IX Header "COPYRIGHT" \&\s-1IBM\s0 Corporation 2000. All Rights Reserved. .PP This documentation is covered by the \s-1IBM\s0 Public License Version 1.0. It was converted from \s-1HTML\s0 to \s-1POD\s0 by software written by Chas Williams and Russ Allbery, based on work by Alf Wachsmann and Elizabeth Cassell.