bos delete(8dfs)

Synopsis

bos delete -server machine -process server_process... [{-noauth | -localauth}] [-help]

Options

-server machine
Names the server machine from which to delete one or more server processes. The BOS Server on this machine executes the command. To run this command using a privileged identity, specify the full DCE path name of the machine. To run this command using the unprivileged identity nobody (the equivalent of running the command with the -noauth option), specify the machine's host name or IP address.

-process server_process
Names each process to delete. Use the name assigned with the -process option in the bos create command; if necessary, use the bos status command to list the possible process names.

-noauth
Directs bos to use the unprivileged identity nobody as the identity of the issuer of the command. The command fails if you use this option and DFS authorization checking is not disabled on the machine specified by -server. 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 delete command removes each indicated server process entry from the BosConfig file on the server machine specified by -server. Before issuing this command, the issuer must use the bos stop command to stop each indicated process, both simple and cron, running on -server. An error message results if the status flag of a process being deleted is Run when this command is issued.

Privilege Required
You must be listed in the admin.bos file on the machine specified by -server.

Examples
The following command removes the flserver process entry from the BosConfig file on the machine named fs3:

$ bos delete /.../abc.com/hosts/fs3 flserver

Related Information
Commands: bos create(8dfs)

Files: BosConfig(4dfs)