svcs(1) 							   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 [-v] [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 ser-
			   vice 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  sepa-
					 rated 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 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-evalua-
						    tion.

					 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 or -l, displays verbose columns: STATE, NSTATE, STIME, CTID, and FMRI.

			   With -x, displays extra information for each explanation.

			   With -l, displays user-visible properties in property groups of type application and their description.

       -x		   Displays explanations for service states.

			   Without arguments, the -x option explains the states of services which:

			       o      are enabled, but are not running.

			       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 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 transi-
		 tion, 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. 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
	 ...
	 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

       ps(1), svcprop(1), svcadm(1M), svccfg(1M), svc.startd(1M), stat(2), libscf(3LIB), attributes(5), fnmatch(5), smf(5)

SunOS 5.11							    6 Nov 2008								   svcs(1)