NAME

bos_getrestricted - Displays whether a bos server is restricted or not

SYNOPSIS

bos getrestricted -server <machine name> [-cell <cell name>] [-noauth] [-localauth] [-help]

DESCRIPTION

The bos getrestricted command shows whether the server machine named by the -server argument is running in restricted mode.

Restricted mode limits access to certain bos commands. See bos_setrestricted(8) for details of which commands are disabled by restricting a server.

Use the bos setrestricted command to restrict, or un-restrict, a server.

OPTIONS

-server <machine name>

Indicates the server machine for which to display the restart times. Identify the machine by IP address or its host name (either fully-qualified or abbreviated unambiguously). For details, see bos(8).

-cell <cell name>

Names the cell in which to run the command. Do not combine this argument with the -localauth flag. For more details, see bos(8).

-noauth

Assigns the unprivileged identity anonymous to the issuer. Do not combine this flag with the -localauth flag. For more details, see bos(8).

-localauth

Constructs a server ticket using a key from the local /usr/afs/etc/KeyFile file. The bos command interpreter presents the ticket to the BOS Server during mutual authentication. Do not combine this flag with the -cell or -noauth options. For more details, see bos(8).

-help

Prints the online help for this command. All other valid options are ignored.

OUTPUT

The output consists of a single line

   Restricted mode is <val>

Where <val> is "on" or "off"

PRIVILEGE REQUIRED

None

SEE ALSO

BosConfig(5), bos(8), bos_setrestricted(8)

COPYRIGHT

Copyright 2009 Simon Wilkinson <simon@sxw.org.uk>

This documentation is covered by the BSD License as written in the doc/LICENSE file. This man page was written by Simon Wilkinson for OpenAFS.