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:

See Also

attributes(5)