12721 would like svcadm disable -c

@@ -8,12 +8,12 @@
 SYNOPSIS
        /usr/sbin/svcadm [-S state] [-v] [-Z | -z zone] enable [-rst]
             [{FMRI | pattern}...]
 
 
-       /usr/sbin/svcadm [-S state] [-v] [-Z | -z zone] disable [-st]
-            [{FMRI | pattern}...]
+       /usr/sbin/svcadm [-S state] [-v] [-Z | -z zone] disable
+            [-c -comment] [-st] [{FMRI | pattern}...]
 
 
        /usr/sbin/svcadm [-S state] [-v] [-Z | -z zone] restart [-d]
             [{FMRI | pattern}...]
 

@@ -103,11 +103,11 @@
            action requires permission to modify the "restarter_actions"
            property group of the service instance (see smf_security(5)). By
            default, enable is persistent across reboot.
 
 
-       disable [-st] {FMRI | pattern}...
+       disable [-c comment] [-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 disabled state.  This action requires permission to modify the
            "general" property group of the service instance (see

@@ -122,11 +122,16 @@
            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)). By
            default, disable is persistent across reboot.
 
+           If the -c option is specified, the given free-form comment is
+           recorded in the (temporary) service configuration under the
+           general/comment property.  This can serve as an administrator
+           reason for disabling the service, and is reported by svcs(1).
 
+
        restart [-d] {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

@@ -291,18 +296,19 @@
 
          # svcadm restart nfs/server
 
 
 
-       Example 2 Disabling the Standard HTTP Server
+       Example 2 Disabling a service
 
 
-       The following command disables the standard HTTP server, using an
-       abbreviated FMRI:
+       The following command synchronously disables a service, using an
+       abbreviated FMRI, and recording a ticket ID as the administrative
+       reason:
 
 
-         $ svcadm disable http
+         $ svcadm disable -c "OPS-1000" -s http
 
 
 
        Example 3 Enabling an Instance and Its Dependent Instances
 

@@ -410,6 +416,6 @@
        necessary to search the directory containing the file. This limitation
        may be removed in a future release.
 
 
 
-                               October 24, 2019                     SVCADM(1M)
+                                 May 11, 2020                       SVCADM(1M)