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

locator - location indicator control

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

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.

The following options are supported:

-f

Turns the locator off.

-n

Turns the locator on.

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

The following exit values are returned:

0

Successful completion.

1

Invalid command line input.

2

The requested operation failed.

attributes(7)

September 4, 2001 OmniOS