locator(1M)

NAME

     locator - location indicator control

SYNOPSIS

      /usr/sbin/locator [-f | -n]

DESCRIPTION

     The locator command sets or queries the state of the  system
     locator if such a device exists.

     Without options, the locator  command  reports  the  current
     state of the system.

     The privileges required to use  this  command  are  hardware
     dependent.  Typically,  only the super user can get or set a
     locator.

OPTIONS

     The following options are supported:

     -f    Turns the locator off.

     -n    Turns the locator on.

OPERANDS

     The following operands are supported:

EXAMPLES

     Example 1: Using the locator Command on a Platform Which Has
     a System Locator LED

     When issued on a platform which has a  system  locator  LED,
     the following command turns the locator on:

     # locator -n
     # locator
     The 'system' locator is on

     Example 2: Using the locator Command  on  a  Platform  Which
     Does Not Have a System Locator LED

     When issued on a platform which does not have a system loca-
     tor  LED, the following command attempts to turn the locator
     on. The command returns an error message.

     # locator -n
     'system' locator not found

EXIT STATUS

     The following exit values are returned:

     0     Successful completion.

     1     Invalid command line input.

     2     The requested operation failed.

ATTRIBUTES

     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|

SEE ALSO

     attributes(5)