locator(1m) - osol9

1locator(1M)             System Administration Commands             locator(1M)
2
3
4

NAME

6       locator - location indicator control
7

SYNOPSIS

9        /usr/sbin/locator [-f | -n]
10
11

DESCRIPTION

13       The  locator command sets or queries the state of the system locator if
14       such a device exists.
15
16
17       Without options, the locator command reports the current state  of  the
18       system.
19
20
21       The  privileges  required  to  use this command are hardware dependent.
22       Typically, only the super user can get or set a locator.
23

OPTIONS

25       The following options are supported:
26
27       -f    Turns the locator off.
28
29
30       -n    Turns the locator on.
31
32

EXAMPLES

34       Example 1 Using the locator Command on a Platform Which  Has  a  System
35       Locator LED
36
37
38       When issued on a platform which has a system locator LED, the following
39       command turns the locator on:
40
41
42         # locator -n
43         # locator
44         The 'system' locator is on
45
46
47
48       Example 2 Using the locator Command on a Platform Which Does Not Have a
49       System Locator LED
50
51
52       When issued on a platform which does not have a system locator LED, the
53       following command attempts to turn the locator on. The command  returns
54       an error message.
55
56
57         # locator -n
58         'system' locator not found
59
60
61

EXIT STATUS

63       The following exit values are returned:
64
65       0    Successful completion.
66
67
68       1    Invalid command line input.
69
70
71       2    The requested operation failed.
72
73

ATTRIBUTES

75       See attributes(5) for descriptions of the following attributes:
76
77
78
79
80       ┌─────────────────────────────┬─────────────────────────────┐
81       │      ATTRIBUTE TYPE         │      ATTRIBUTE VALUE        │
82       ├─────────────────────────────┼─────────────────────────────┤
83       │Availability                 │SUNWcsu                      │
84       └─────────────────────────────┴─────────────────────────────┘
85