bos getdates(8dfs)

Lists time stamps on versions of binary files

Synopsis

bos getdates -server machine -file binary_file... [-dir alternate_dest]
[{-noauth | -localauth}] [-help]

Options

-server machine
Names the server machine that houses the binary files whose time stamps are 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.

-file binary_file
Names the current version of each binary file whose time stamps are to be displayed. The time stamps on the current, .BAK, and .OLD versions of each file are displayed. All specified files must reside in the same directory (dcelocal/bin, by default, or an alternate directory specified with the -dir option). Specify only file names; if a path name is provided for a file, the command ignores all but the final element.

-dir alternate_dest
Provides the path name of the directory in which all specified files reside. Omit this option if the files reside in the default directory, dcelocal/bin; otherwise, provide a full or relative path name. Relative path names (path names that do not begin with a slash) are interpreted relative to the dcelocal directory on the machine specified by -server.

-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 getdates command displays the time stamps for the current, .BAK, and .OLD versions of each binary file whose current version is specified with the -file option. The time stamps record when the files were installed. The command displays a message for any version of a specified file that does not exist. Use the -server option to specify the name of the server machine on which the files reside. The -dir option can be used to specify the name of the directory in which the files reside if it is different from dcelocal/bin.

The BOS Server automatically creates .BAK and .OLD versions when new binaries are installed with bos install. Use the bos uninstall command to replace the current version with its next-oldest version (.BAK or, if the .BAK version does not exist, .OLD) or to remove all versions of a binary file. Use the bos prune command to remove .BAK and .OLD files from the dcelocal/bin directory (the command can also be used to remove core files from the dcelocal/var/dfs/adm directory).

Privilege Required
No privileges are required.

Output
For each file specified with the -file option, the output reports the time stamps on the current, .BAK, and .OLD versions. The output displays a message to indicate any version that does not exist.

Examples
The following command displays the time stamps on the three versions of the flserver binary file stored in the default directory on the server machine named fs2:

$ bos getdates /.../abc.com/hosts/fs2 flserver

Related Information
Command: bos install(8dfs)

bos prune(8dfs)

bos uninstall(8dfs)