Gang,
I'm looking at RFE/bug -- 6182530: svcadm alias "enable -t" as start and
"disable -t" as stop
(found here http://bugs.opensolaris.org/view_bug.do?bug_id=6182530 ).
I'd like to invite opinions.
With the integration of 5100812, I believe we're down to the following
features described in the RFE.
1) Provide an alias for enable -(s)t and disable -(s)t
2) Clear up any documentation indicating that -t enabled/disabled services
revert to previous states.
I am having trouble finding reference in any man page text indicating that
the service may revert to a previous state if
enabled/disabled with -t. I've looked in 10u3, 10u4, docs.sun.com, and snv
73. I believe we can dismiss the second point above.
Regarding the first point, I propose the following:
Add 2 commands to svcadm: start and stop, which would be aliased to "enable
-st" and "disable -st" respectively. I believe that, as Liane indicated a
preference for in an earlier email, the -s modifier should be included to
provide full service startup checking and fail-fast semantics. If the user
of start/stop wants to skip the -s modifier, they can use "enable/disable
-t", which should be mentioned in the documentation.
Both commands would have the modifier -v and start will have the -r
modifier. Both be documented as (first order) commands. Their description
will simply note that they are really just aliases to enable/disable -st.
"-v" would indicate verbose output, and "start -r" would translate as a full
alias to "enable -rst".
Example man page follows.
-bash-3.00$ uname -a
SunOS isildur 5.11 snv_73 sun4u sparc SUNW,Sun-Blade-1000
-bash-3.00$ man svcadm | col -x -b >svcadm.snv73.man.txt
-bash-3.00$ diff -u svcadm.snv73.man.txt svcadm.snv73.man.txt.revised
--- svcadm.snv73.man.txt Sun Oct 28 12:15:05 2007
+++ svcadm.snv73.man.txt.revised Sun Oct 28 12:41:48 2007
@@ -15,6 +15,12 @@
/usr/sbin/svcadm [-v] disable [-st] {FMRI | pattern}...
+ /usr/sbin/svcadm [-v] start [-r] {FMRI | pattern}...
+
+
+ /usr/sbin/svcadm [-v] stop [-r] {FMRI | pattern}...
+
+
/usr/sbin/svcadm [-v] restart {FMRI | pattern}...
@@ -121,6 +127,34 @@
able is persistent across reboot.
+ start [-r] {FMRI | pattern}. . .
+
+ Temporarily 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
+ "restarter_actions" property group of the service
+ instance (see smf_security(5)). This command is
+ essentially an alias to "enable -st", and as such, will
+ only last until reboot.
+
+ If the -r option is specified, svcadm temporarily
+ enables each service instance and recursively enables
+ its dependencies.
+
+
+ stop {FMRI | pattern}. . .
+
+ Temporarily 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
+ "restarter_actions" property group of the service
+ instance (see smf_security(5)). This command is
+ essentially an alias to "disable -st", and as such,
+ will only last until reboot.
+
+
restart {FMRI | pattern}. . .
Mark
--
------------------------------------------------------
Born to the false world, the wanderer,
Storyteller, The Pied Piper
On a quest for immortality
Gathering a troop to find the fantasy
-- Nightwish
-------------- next part --------------
An HTML attachment was scrubbed...
URL:
<http://mail.opensolaris.org/pipermail/smf-discuss/attachments/20071028/ab5764a8/attachment.html>
