Print this page
5112 svcadm manpage needs more 5021-related updates
5593 Recent versions of svcadm invoked for multiple FMRIs say "Partial FMRI matches multiple instances"
8688 svcadm does not handle multiple partial FMRI arguments
Reviewed by: Dominik Hassler <hadfl@omniosce.org>


 256 
 257                     mail
 258                     network
 259                     network/smt
 260 
 261 
 262                   If the FMRI specifies a service, then the command applies to
 263                   all instances of that service. Abbreviated forms of FMRIs
 264                   are unstable, and should not be used in scripts or other
 265                   permanent tools.
 266 
 267 
 268        pattern
 269                   A pattern that is matched against the FMRIs of service
 270                   instances according to the "globbing" rules described by
 271                   fnmatch(5). If the pattern does not begin with "svc:", then
 272                   "svc:/" is prepended.
 273 
 274 
 275 
 276        If an abbreviated FMRI or pattern matches more than one service, a
 277        warning message is displayed and that operand is ignored.

 278 
 279 EXAMPLES
 280        Example 1 Restarting a Service Instance
 281 
 282 
 283        The following command restarts the NFS server. The full FMRI for the
 284        default service instance is: svc:/network/nfs/server:default
 285 
 286 
 287 
 288        However, you can abbreviate the full FMRI as follows:
 289 
 290 
 291          # svcadm restart nfs/server
 292 
 293 
 294 
 295        Example 2 Disabling the Standard HTTP Server
 296 
 297 


 390        interactive output are Committed.
 391 
 392 SEE ALSO
 393        svcprop(1), svcs(1), inetd(1M), init(1M), svccfg(1M), svc.startd(1M),
 394        libscf(3LIB), contract(4), attributes(5), smf(5), smf_security(5),
 395        zones(5)
 396 
 397 NOTES
 398        The amount of time svcadm will spend waiting for services and their
 399        dependencies to change state is implicitly limited by their method
 400        timeouts.  For example, a service using the default restarter whose
 401        start method hangs will be transitioned to the maintenance state when
 402        its timeout expires.  svcadm will then consider it impossible for this
 403        service to come online without administrator intervention.
 404 
 405 
 406        Attempts to synchronously enable a service which depends (directly or
 407        indirectly) on a file may fail with an exit status indicating that
 408        dependencies are unsatisfied if the caller does not have the privileges
 409        necessary to search the directory containing the file. This limitation
 410        may be removed in a future Solaris release.
 411 
 412 
 413 
 414                                   May 9, 2008                       SVCADM(1M)


 256 
 257                     mail
 258                     network
 259                     network/smt
 260 
 261 
 262                   If the FMRI specifies a service, then the command applies to
 263                   all instances of that service. Abbreviated forms of FMRIs
 264                   are unstable, and should not be used in scripts or other
 265                   permanent tools.
 266 
 267 
 268        pattern
 269                   A pattern that is matched against the FMRIs of service
 270                   instances according to the "globbing" rules described by
 271                   fnmatch(5). If the pattern does not begin with "svc:", then
 272                   "svc:/" is prepended.
 273 
 274 
 275 
 276        If an abbreviated FMRI matches more than one service, a warning message
 277        is displayed and that operand is ignored.  If a pattern matches more
 278        than one service or instance, the subcommand is applied to all matches.
 279 
 280 EXAMPLES
 281        Example 1 Restarting a Service Instance
 282 
 283 
 284        The following command restarts the NFS server. The full FMRI for the
 285        default service instance is: svc:/network/nfs/server:default
 286 
 287 
 288 
 289        However, you can abbreviate the full FMRI as follows:
 290 
 291 
 292          # svcadm restart nfs/server
 293 
 294 
 295 
 296        Example 2 Disabling the Standard HTTP Server
 297 
 298 


 391        interactive output are Committed.
 392 
 393 SEE ALSO
 394        svcprop(1), svcs(1), inetd(1M), init(1M), svccfg(1M), svc.startd(1M),
 395        libscf(3LIB), contract(4), attributes(5), smf(5), smf_security(5),
 396        zones(5)
 397 
 398 NOTES
 399        The amount of time svcadm will spend waiting for services and their
 400        dependencies to change state is implicitly limited by their method
 401        timeouts.  For example, a service using the default restarter whose
 402        start method hangs will be transitioned to the maintenance state when
 403        its timeout expires.  svcadm will then consider it impossible for this
 404        service to come online without administrator intervention.
 405 
 406 
 407        Attempts to synchronously enable a service which depends (directly or
 408        indirectly) on a file may fail with an exit status indicating that
 409        dependencies are unsatisfied if the caller does not have the privileges
 410        necessary to search the directory containing the file. This limitation
 411        may be removed in a future release.
 412 
 413 
 414 
 415                                October 17, 2017                     SVCADM(1M)