bos lscell(8dfs)

Lists the cell in which the BOS Server is running

Synopsis

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

Options

-server machine
Names the server machine on which the BOS Server whose cell is to be listed is running. 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 lscell command reports the name of the cell in which the BOS Server on the machine specified with the -server option is running. The command extracts the information from the local configuration file, dcelocal/dce_cf.db, on the specified machine. If the command fails after being issued from the machine specified by -server (if -server is the local machine), the failure may indicate that the local dce_cf.db file is corrupted; use the cat or more command (or a similar command appropriate to your operating system) to display the contents of the file, and ensure that it is not corrupted.

Privilege Required
No privileges are required.

Output
The bos lscell command displays the following line reporting the name of the cell in which the BOS Server is running:

Cell name is cellname

Examples
The following command displays the name of the cell in which the BOS Server on the machine named fs1 is running:

$ bos lscell /.../abc.com/hosts/fs1

Cell name is abc.com