locator(1m) opensolaris man page | unix.com

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)