Solaris man マニュアル
System Administration Commands                         svcadm(1M)

NAME
     svcadm - manipulate service instances

SYNOPSIS
     /usr/sbin/svcadm [-v] enable [-rst] {FMRI | pattern}...

     /usr/sbin/svcadm [-v] disable [-st] {FMRI | pattern}...

     /usr/sbin/svcadm [-v] restart {FMRI | pattern}...

     /usr/sbin/svcadm [-v] refresh {FMRI | pattern}...

     /usr/sbin/svcadm [-v] clear {FMRI | pattern}...

     /usr/sbin/svcadm [-v] mark [-It] instance_state {FMRI | pat-
     tern}...

     /usr/sbin/svcadm [-v] milestone [-d] milestone_FMRI

     /usr/sbin/svcadm [-v] restarter_FMRI {FMRI | pattern}...

DESCRIPTION
     svcadm issues requests for  actions  on  services  executing
     within the service management facility (see smf(5)). Actions
     for a service are carried out by its assigned  service  res-
     tarter  agent.  The  default service restarter is svc.startd
     (see svc.startd(1M)).

OPTIONS
     The following options are supported:

     -v              Print actions verbosely to standard output.



SUBCOMMANDS
  Common Operations
     The  following  subcommands  are  used  during  the  typical
     administration of a service instance.

     For subcommands taking one or more operands, if the  operand
     specifies  a  service  (instead  of a service instance), and
     that service has only a single instance, svcadm operates  on
     that  instance.  If  an  abbreviated FMRI or pattern matches
     more than one service, a warning message  is  displayed  and
     that operand is ignored.

     In the case that the service has  more  than  one  instance,
     svcadm return a non-zero exit status.

     enable [-rst] {FMRI | pattern}. . .

         Enables the service instances specified by the operands.
         For  each  service instance, the assigned restarter will
         try to  bring  it  to  the  online  state.  This  action
         requires  permission  to  modify  the "general" property
         group of the service instance (see smf_security(5)).

         If the -r option is specified, svcadm enables each  ser-
         vice instance and recursively enables its dependencies.

         If the -s option is specified, svcadm enables each  ser-
         vice  instance  and then waits for each service instance
         to enter the  online  or  degraded  state.  svcadm  will
         return  early  if  it determines that the service cannot
         reach these states without administrator intervention.

         If  the  -t  option  is  specified,  svcadm  temporarily
         enables  each  service  instance.  Temporary enable only
         lasts until reboot. This action requires  permission  to
         modify  the  "restarter_actions"  property  group of the
         service instance (see smf_security(5)).



     disable [-st] {FMRI | pattern}. . .

         Disables the service instance specified by the operands.
         For  each  service instance, the assigned restarter will
         try to bring  it  to  the  online  state.   This  action
         requires  permission  to  modify  the "general" property
         group of the service instance (see smf_security(5)).

         If the -s option is specified, svcadm disables each ser-
         vice  instance  and then waits for each service instance
         to enter the disabled state. svcadm will return early if
         it  determines  that the service cannot reach this state
         without administrator intervention.

         If the -t option is specified, svcadm  temporarily  dis-
         ables  each  service  instance.  Temporary  disable only
         lasts until reboot. This action requires  permission  to
         modify  the  "restarter_actions"  property  group of the
         service instance (see smf_security(5)).



     restart {FMRI| pattern}. . .

         Requests that the service  instances  specified  by  the
         operands  be  restarted. This action requires permission
         to modify the "restarter_actions" property group of  the
         service instance (see smf_security(5)).



     refresh {FMRI| pattern}. . .

         For each service instance  specified  by  the  operands,
         requests   that   the   assigned  restarter  update  the
         service's running configuration snapshot with the values
         from  the  current  configuration.  Some of these values
         take  effect  immediately   (for   example,   dependency
         changes). Other values do not take effect until the next
         service restart. See the restarter and service  documen-
         tation for more information.

         If the service is managed by svc.startd(1M), the refresh
         method  will be invoked if it exists to request the ser-
         vice reread its own configuration. For other restarters,
         see the restarter documentation.

         This  action   requires   permission   to   modify   the
         "restarter_actions"   property   group  of  the  service
         instance (see smf_security(5)).



     clear {FMRI| pattern}. . .

         For each service instance specified by the operands,  if
         the  instance is in the maintenance state, signal to the
         assigned restarter that the service has  been  repaired.
         If  the  instance is in the degraded state, request that
         the assigned restarter take the service  to  the  online
         state.  This  action  requires  permission to modify the
         "restarter_actions"  property  group  of   the   service
         instance (see smf_security(5)).



  Exceptional Operations
     The following subcommands are used for  service  development
     and temporary administrative manipulation.

     mark [-It] instance_state {FMRI| pattern}. . .

         If instance_state is "maintenance", then for  each  ser-
         vice specified by the operands, svcadm requests that the
         assigned restarter place the service in the  maintenance
         state.  See  svc.startd(1M) and inetd(1M) for a detailed
         description of the actions taken for each restarter.

         If  instance_state  is  "degraded",  then  for  services
         specified  by  the  operands in the online state, svcadm
         requests that the restarters assigned  to  the  services
         move them into the degraded state.

         If the -I option is specified, the request is flagged as
         immediate.

         The -t option is only valid  for  maintenance  requests.
         When this option is specified, the request is flagged as
         temporary, and its effect will only last until the  next
         reboot.



     milestone [-d] milestone_FMRI

         If milestone_FMRI is the keyword "all", temporary enable
         and disable requests for all services will be nullified.

         If milestone_FMRI is the keyword  "none",  all  services
         other       than       the       master       restarter,
         svc:/system/svc/restarter:default, will  be  temporarily
         disabled.

         If milestone_FMRI is one of the following:

         svc:/milestone/single-user:default
         svc:/milestone/multi-user:default
         svc:/milestone/multi-user-server:default

         then temporary enable and disable requests for the indi-
         cated  service  and all services it depends on (directly
         or indirectly) will be  nullified.  All  other  services
         will be temporarily disabled.

         This  action   requires   permission   to   modify   the
         "options_ovr"       property      group      of      the
         svc:/system/svc/restarter:default service instance  (see
         smf_security(5)).

         The -d option causes svcadm to make the given  milestone
         the   default  boot  milestone,  which  persists  across
         reboots.   The  default  milestone  is  defined  by  the
         options/milestone  property  on  the  master  restarter,
         svc:/system/svc/restarter:default. If this  property  is
         absent, "all" is the default.  This action requires per-
         mission to modify the "options" property  group  of  the
         svc:/system/svc/restarter:default  service instance (see
         smf_security(5)).



  Operands
     The following operands are supported:


     FMRI                    An FMRI that specifies one  or  more
                             instances.  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

                             All the following are valid abbrevi-
                             ations:

                             sendmail
                             :sendmail
                             smtp
                             smtp:sendmail
                             network/smtp

                             While the following are invalid:

                             mail
                             network
                             network/smt

                             If the  FMRI  specifies  a  service,
                             then  the  command  applies  to  all
                             instances of that service.  Abbrevi-
                             ated  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 pat-
                             tern does  not  begin  with  "svc:",
                             then "svc:/" is prepended.



     If an abbreviated FMRI or pattern matches more than one ser-
     vice,  a  warning  message  is displayed and that operand is
     ignored.

EXAMPLES
     Example 1: Disabling the Standard HTTP Server

     The following command disables  the  standard  HTTP  server,
     using an abbreviated FMRI:

     $ svcadm disable http

     Example 2: Enabling an Instance and Its Dependent Instances

     The following command enables the foo:bar instance, and  all
     instances on which it depends:

     $ svcadm enable -r foo:bar

     Example 3: Synchronously enabling an instance

     The following command enables  the  foo:bar  instance.   The
     command  will  not return until the instance comes online or
     svcadm determines it is not possible for the service to come
     online.

     $ svcadm enable -s foo:bar

     Example 4: Restricting and Restoring the Running Services

     The following command restricts the running services to sin-
     gle user mode:

     # svcadm milestone milestone/single-user

     The following command restores the running services:

     # svcadm milestone all

EXIT STATUS
     The following exit values are returned:

     0        Successful completion.



     1        A fatal error occurred. One or more error  messages
              are displayed on standard error.



     2        Invalid command line options were specified.



     3        svcadm determined that a service instance  that  it
              was  waiting  for could not reach the desired state
              without administrator intervention due to a problem
              with the service instance itself.


     4        svcadm determined that a service instance  that  it
              was  waiting  for could not reach the desired state
              without administrator intervention due to a problem
              with the service's dependencies.



ATTRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     ____________________________________________________________
    |       ATTRIBUTE TYPE        |       ATTRIBUTE VALUE       |
    |_____________________________|_____________________________|
    | Availability                | SUNWcsu                     |
    |_____________________________|_____________________________|
    | Interface Stability         | See below.                  |
    |_____________________________|_____________________________|


     The interactive output is Unstable. The invocation and  non-
     interactive output are Evolving.

SEE ALSO
     inetd(1M),           svc.startd(1M),           libscf(3LIB),
     contract(4),attributes(5), smf(5), smf_security(5)

NOTES
     The amount of time svcadm will spend  waiting  for  services
     and their dependencies to change state is implicitly limited
     by their method timeouts. For example, a service  using  the
     default  restarter  whose start method hangs will be transi-
     tioned to the maintenance state when  its  timeout  expires.
     svcadm  will then consider it impossible for this service to
     come online without administrator intervention.

     Attempts to synchronously enable  a  service  which  depends
     (directly  or  indirectly)  on  a file may fail with an exit
     status indicating that dependencies are unsatisfied  if  the
     caller  does not have the privileges necessary to search the
     directory  containing  the  file.  This  limitation  may  be
     removed in a future Solaris release.