bos getrestart(8dfs)

Synopsis

bos getrestart -server machine [{-noauth | -localauth}] [-help]

Options

-server machine
Names the server machine on which to check the restart times. The BOS Server on this machine executes the command. Specify the machine's DCE path name, its host name, or its IP address.

-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 getrestart command displays the following two restart times from the BosConfig file on the server machine specified by the -server option:

· The general restart time, which is the time each week when the BOS Server process automatically restarts itself and all processes that have the status flag Run in the BosConfig file

· The new binary restart time, which is the time each day when the BOS Server automatically restarts any process executed from a binary file in the dcelocal/bin directory whose time stamp is later than the last restart time for the process

Either of these times can be daily (consist only of a time) or weekly (consist of a day and time). By default, the general restart time is once a week, while the new binary restart time occurs once a day. Both restart times are set with the bos setrestart command.

Privilege Required
No privileges are required.

Output
The output consists of the following two lines:

Server machine restarts at time

Server machine restarts for new binaries at time

where machine indicates the name of the server machine whose restart times are displayed, and possible values for time include

never
Indicates that the BOS Server never performs that type of restart

A specified day and time
Indicates that the BOS Server performs that type of restart once per week

A specified time
Indicates that the BOS Server performs that type of restart once per day

Examples
The following command displays the restart times for the server machine fs2:

$ bos getr /.../abc.com/hosts/fs2

Server fs2 restarts at sun 4:00 am

Server fs2 restarts for new binaries at 2:15 am

Related Information
Commands: bos setrestart(8dfs)

Files: BosConfig(4dfs)