locator(1M)						  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 locator 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 attributes:

       +-----------------------------+-----------------------------+
       |      ATTRIBUTE TYPE	     |	    ATTRIBUTE VALUE	   |
       +-----------------------------+-----------------------------+
       |Availability		     |SUNWcsu			   |
       +-----------------------------+-----------------------------+

SEE ALSO

       attributes(5)

SunOS 5.11							    4 Sept 2001 						       locator(1M)