샤브의 블로그 RSS 태그 관리 글쓰기 방명록
svcs (1)
2010-09-01 14:20:46

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 repository.

    The first form of this command prints one-line status listings 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 specified 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 services 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.

    -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 service instances depend.

    -D

    Lists the service instances that depend on the given services or service instances.

    -H

    Omits the column headers.

    -l

    (The letter ell.) Displays all available information about the selected services and service instances, with one service attribute displayed for each line. Information 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 properties 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 descriptions:

    absent

    No such service is defined 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.

    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 administrator has run svcadm disable -t, used svcadm milestone, or booted the system to a specific milestone. 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 command 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.

    -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:

    • are enabled, but are not running.

    • 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 trailing portion of the service name. For example, given the FMRI:


    svc:/network/smtp:sendmail

    The following are valid abbreviations:


    sendmail
    :sendmail
    smtp
    smtp:sendmail
    network/smtp

    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 permanent tools.

    pattern

    A pattern that is matched against the FMRIs of service instances according to the “globbing” 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 primary 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.

    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

    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 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.

    STIME

    If the service instance entered the current state within the last 24 hours, this column indicates the time that it did so. Otherwise, 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
    ...
    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 service.


    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 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

    See attributes(5) for descriptions of the following attributes:

    ATTRIBUTE TYPE 

    ATTRIBUTE VALUE 

    Availability 

    SUNWcsu 

    Interface Stability 

    See below. 

    Screen output is Uncommitted. The invocation is Committed.

See Also


'Device & Language > Solaris 10' 카테고리의 다른 글

Hardware Diagnostics for Sun Systems  (0) 2010.09.01
manpages section 1M: System Administration Commands  (0) 2010.09.01
솔10 svcadm  (0) 2010.09.01
fsck-spec  (0) 2010.09.01
fsck– check and repair file systems  (0) 2010.09.01