|
Hopefully, this page is exactly what you are looking for, but if not, you can always find further assistance on Unix/Linux Forum!
User Commands svcs(1)
NAME
svcs - report service status
SYNOPSIS
svcs [-aHpv?] [-o col[,col]...] [-R FMRI-instance]... [-sS
col]... [FMRI | pattern] ...
svcs {-d | -D} [-Hpv?] [-o col[,col]...] [-sS col]...
[FMRI | pattern] ...
svcs -l [FMRI | pattern] ...
svcs -x [-v] [FMRI]...
DESCRIPTION
The svcs command displays information about service
instances as recorded in the service configuration reposi-
tory.
The first form of this command prints one-line status list-
ings for service instances specified by the arguments. Each
instance is listed only once. With no arguments, all enabled
service instances, even if temporarily disabled, are listed
with the columns indicated below.
The second form prints one-line status listings for the
dependencies or dependents of the service instances speci-
fied by the arguments.
The third form prints detailed information about specific
services and instances.
The fourth form explains the states of service instances.
For each argument, a block of human-readable text is
displayed which explains what state the service is in, and
why it is in that state. With no arguments, problematic ser-
vices are described.
Error messages are printed to the standard error stream.
The output of this command can be used appropriately as
input to the svcadm(1M) command.
OPTIONS
The following options are supported:
-? Displays an extended usage message,
including column specifiers.
SunOS 5.10 Last change: 13 Sep 2006 1
User Commands svcs(1)
-a Show all services, even disabled
ones. This option has no effect if
services are selected.
-d Lists the services or service
instances upon which the given ser-
vice instances depend.
-D Lists the service instances that
depend on the given services or ser-
vice instances.
-H Omits the column headers.
-l (The letter ell.) Displays all
available information about the
selected services and service
instances, with one service attri-
bute displayed for each line. Infor-
mation for different instances are
separated by blank lines.
The following specific attributes
require further explanation:
dependency
Information about a dependency.
The grouping and restart_on pro-
perties are displayed first and
are separated by a forward slash
(/). Next, each entity and its
state is listed. See smf(5) for
information about states. In
addition to the standard states,
each service dependency can have
the following state descrip-
tions:
absent
No such service is defined
SunOS 5.10 Last change: 13 Sep 2006 2
User Commands svcs(1)
on the system.
invalid
The fault management
resource identifier (FMRI)
is invalid (see smf(5)).
multiple
The entity is a service with
multiple instances.
File dependencies can only have
one of the following state
descriptions:
absent
No such file on the system.
online
The file exists.
If the file did not exist
the last time that
svc.startd evaluated the
service's dependencies, it
can consider the dependency
to be unsatisfied. svcadm
refresh forces dependency
re-evaluation.
unknown
stat(2) failed for a reason
other than ENOENT.
SunOS 5.10 Last change: 13 Sep 2006 3
User Commands svcs(1)
See smf(5) for additional
details about dependencies,
grouping, and restart_on values.
enabled
Whether the service is enabled
or not, and whether it is
enabled or disabled temporarily
(until the next system reboot).
The former is specified as
either true or false, and the
latter is designated by the
presence of (temporary).
A service might be temporarily
disabled because an administra-
tor has run svcadm disable -t,
used svcadm milestone, or booted
the system to a specific mile-
stone. See svcadm(1M) for
details.
-o col[,col]... Prints the specified columns. Each
col should be a column name. See
COLUMNS below for available columns.
-p Lists processes associated with each
service instance. A service instance
can have no associated processes.
The process ID, start time, and com-
mand name (PID, STIME, and CMD
fields from ps(1)) are displayed for
each process.
-R FMRI-instance Selects service instances that have
the given service instance as their
restarter.
-s col Sorts output by column. col should
be a column name. See COLUMNS below
for available columns. Multiple -s
options behave additively.
SunOS 5.10 Last change: 13 Sep 2006 4
User Commands svcs(1)
-S col Sorts by col in the opposite order
as option -s.
-v Without -x, displays verbose
columns: STATE, NSTATE, STIME, CTID,
and FMRI.
With -x, displays extra information
for each explanation.
-x Displays explanations for service
states.
Without arguments, the -x option
explains the states of services
which:
o are enabled, but are not run-
ning.
o are preventing another enabled
service from running.
OPERANDS
The following operands are supported:
FMRI A fault management resource identifier
(FMRI) that specifies one or more instances
(see smf(5)). FMRIs can be abbreviated by
specifying the instance name, or the trail-
ing portion of the service name. For exam-
ple, given the FMRI:
svc:/network/smtp:sendmail
The following are valid abbreviations:
sendmail
:sendmail
smtp
smtp:sendmail
network/smtp
SunOS 5.10 Last change: 13 Sep 2006 5
User Commands svcs(1)
The following are invalid abbreviations:
mail
network
network/smt
If the FMRI specifies a service, then the
command applies to all instances of that
service, except when used with the -D
option.
Abbreviated forms of FMRIs are unstable, and
should not be used in scripts or other per-
manent tools.
pattern A pattern that is matched against the FMRIs
of service instances according to the "glob-
bing" rules described by fnmatch(5). If the
pattern does not begin with svc:, then svc:/
is prepended. The following is a typical
example of a glob pattern:
qexample% svcs \*keyserv\*
STATE STIME FMRI
disabled Aug_02 svc:/network/rpc/keyserv:default
FMRI-instance An FMRI that specifies an instance.
COLUMNS
Column names are case insensitive. The default output format
is equivalent to "-o state,stime,fmri". The default sorting
columns are STATE, STIME, FMRI.
CTID The primary contract ID for the service
instance. Not all instances have valid pri-
mary contract IDs.
DESC A brief description of the service, from its
template element. A service might not have a
description available, in which case a
hyphen (-) is used to denote an empty value.
SunOS 5.10 Last change: 13 Sep 2006 6
User Commands svcs(1)
FMRI The FMRI of the service instance.
INST The instance name of the service instance.
NSTA The abbreviated next state of the service
instance, as given in the STA column
description. A hyphen denotes that the
instance is not transitioning. Same as STA
otherwise.
NSTATE The next state of the service. A hyphen is
used to denote that the instance is not
transitioning. Same as STATE otherwise.
SCOPE The scope name of the service instance.
SVC The service name of the service instance.
STA The abbreviated state of the service
instance (see smf(5)):
DGD degraded
DIS disabled
LRC legacy rc*.d script-initiated
instance
MNT maintenance
SunOS 5.10 Last change: 13 Sep 2006 7
User Commands svcs(1)
OFF offline
ON online
UN uninitialized
Absent or unrecognized states are denoted by
a question mark (?) character. An asterisk
(*) is appended for instances in transition,
unless the NSTA or NSTATE column is also
being displayed.
See smf(5) for an explanation of service
states.
STATE The state of the service instance. An aster-
isk is appended for instances in transition,
unless the NSTA or NSTATE column is also
being displayed.
See smf(5) for an explanation of service
states.
STIME If the service instance entered the current
state within the last 24 hours, this column
indicates the time that it did so. Other-
wise, this column indicates the date on
which it did so, printed with underscores
(_) in place of blanks.
EXAMPLES
Example 1: Displaying the Default Output
This example displays default output:
example% svcs
STATE STIME FMRI
...
legacy_run 13:25:04 lrc:/etc/rc3_d/S42myscript
...
online 13:21:50 svc:/system/svc/restarter:default
...
SunOS 5.10 Last change: 13 Sep 2006 8
User Commands svcs(1)
online 13:25:03 svc:/milestone/multi-user:default
...
online 13:25:07 svc:/milestone/multi-user-server:default
...
Example 2: Listing All Local Instances
This example lists all local instances of the service1 ser-
vice.
example% svcs -o state,nstate,fmri service1
STATE NSTATE FMRI
online - svc:/service1:instance1
disabled - svc:/service1:instance2
Example 3: Listing Verbose Information
This example lists verbose information.
example% svcs -v network/rpc/rstat:udp
STATE NSTATE STIME CTID FMRI
online - Aug_09 - svc:/network/rpc/rstat:udp
Example 4: Listing Detailed Information
This example lists detailed information about all instances
of system/service3. Additional fields can be displayed, as
appropriate to the managing restarter.
example% svcs -l network/rpc/rstat:udp
fmri svc:/network/rpc/rstat:udp
enabled true
state online
next_state none
restarter svc:/network/inetd:default
contract_id
dependency require_all/error svc:/network/rpc/bind (online)
Example 5: Listing Processes
example% svcs -p sendmail
STATE STIME FMRI
online 13:25:13 svc:/network/smtp:sendmail
13:25:15 100939 sendmail
13:25:15 100940 sendmail
Example 6: Explaining Service States Using svcs -x
(a) In this example, svcs -x has identified that the
print/server service being disabled is the root cause of two
services which are enabled but not online. svcs -xv shows
SunOS 5.10 Last change: 13 Sep 2006 9
User Commands svcs(1)
that those services are print/rfc1179 and print/ipp-
listener. This situation can be rectified by either enabling
print/server or disabling rfc1179 and ipp-listener.
example% svcs -x
svc:/application/print/server:default (LP print server)
State: disabled since Mon Feb 13 17:56:21 2006
Reason: Disabled by an administrator.
See: http://sun.com/msg/SMF-8000-05
See: lpsched(1M)
Impact: 2 dependent services are not running. (Use -v for list.)
(b) In this example, NFS is not working:
example$ svcs nfs/client
STATE STIME FMRI
offline 16:03:23 svc:/network/nfs/client:default
(c) The following example shows that the problem is
nfs/status. nfs/client is waiting because it depends on
nfs/nlockmgr, which depends on nfs/status:
example$ svcs -xv nfs/client
svc:/network/nfs/client:default (NFS client)
State: offline since Mon Feb 27 16:03:23 2006
Reason: Service svc:/network/nfs/status:default
is not running because a method failed repeatedly.
See: http://sun.com/msg/SMF-8000-GE
Path: svc:/network/nfs/client:default
svc:/network/nfs/nlockmgr:default
svc:/network/nfs/status:default
See: man -M /usr/share/man -s 1M mount_nfs
See: /var/svc/log/network-nfs-client:default.log
Impact: This service is not running.
EXIT STATUS
The following exit values are returned:
0 Successful command invocation.
1 Fatal error.
2 Invalid command line options were specified.
ATTRIBUTES
SunOS 5.10 Last change: 13 Sep 2006 10
User Commands svcs(1)
See attributes(5) for descriptions of the following attri-
butes:
____________________________________________________________
| ATTRIBUTE TYPE | ATTRIBUTE VALUE |
|_____________________________|_____________________________|
| Availability | SUNWcsu |
|_____________________________|_____________________________|
| Interface Stability | See below. |
|_____________________________|_____________________________|
Screen output is Unstable. The invocation is Evolving.
SEE ALSO
ps(1), svcprop(1), svcadm(1M), svccfg(1M), svc.startd(1M),
stat(2), libscf(3LIB), attributes(5), fnmatch(5), smf(5)
SunOS 5.10 Last change: 13 Sep 2006 11
Man(1) output converted with
man2html and wrapped by fishsponge
This page was generated on Wed Sep 12 11:25:30 GMT 2007
|
Your favourite pages:
No pages logged yet.
Trying to save cookie... Top 10 most popular pages:
sqlite3 man page (5334 hits)
(openSUSE 10.2)
svn man page (5209 hits)
(FreeBSD 6.2)
adv_cap_autoneg man page (4870 hits)
(Solaris 10 11_06)
CPAN man page (4607 hits)
(Suse Linux 10.1)
ssh man page (4342 hits)
(Suse Linux 10.1)
ssh-socks5-proxy-connect man page (2884 hits)
(Solaris 10 11_06)
netcat man page (2717 hits)
(Suse Linux 10.1)
pprosetup man page (2492 hits)
(Solaris 10 11_06)
startproc man page (2471 hits)
(Suse Linux 10.1)
signal man page (2408 hits)
(Suse Linux 10.1)
|
Man Pages 
