LOCATOR(8) Maintenance Commands and Procedures LOCATOR(8)

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.

SEE ALSO

attributes(7)

September 4, 2001 LOCATOR(8)