System Administration Commands                        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.


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.




SunOS 5.11          Last change: 4 Sept 2001                    1






System Administration Commands                        locator(1M)



       # 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.


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



     
           ATRIBUTE TYPE               ATRIBUTE VALUE       
    
     Availability                 SUNWcsu                     
    


SEE ALSO
     attributes(5)























SunOS 5.11          Last change: 4 Sept 2001                    2