Project

General

Profile

Actions

Bug #5112

closed

svcadm manpage needs more 5021-related updates

Added by Josef Sipek almost 8 years ago. Updated over 4 years ago.

Status:
Closed
Priority:
Low
Assignee:
-
Category:
manpage - manual pages
Start date:
2014-08-21
Due date:
% Done:

100%

Estimated time:
Difficulty:
Bite-size
Tags:
needs-triage
Gerrit CR:

Description

In #5021, the svcadm manpage got updated to reflect the new behavior. Unfortunately, the "Operands" subsection didn't get updated to reflect this new behavior. (Yes, there are at least two places in the manpage that describe handling of multiple matches.)

Furthermore, unless you know the difference between a FMRI (possibly an abbreviated one) and a pattern, then the current text makes no sense - it seems to contradict itself.

 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,
 \\fBsvcadm\\fR operates on that instance. If an abbreviated \\fIFMRI\\fR (a fault
 management resource identifier) matches more than one service or instance, a
 warning message is displayed and that operand is ignored.
 If a pattern matches more than one service or instance, the subcommand is
 applied to all matches. See \\fBsmf\\fR(5).

The second and third cases seem to have the same condition (they do not since FMRI != pattern), but a different end result. This should be clarified.


Related issues

Related to illumos gate - Feature #5021: SMF: allow svcadm to act on multiple instances simultaneouslyClosedJerry Jelinek2014-07-18

Actions
Related to illumos gate - Bug #8688: svcadm does not handle multiple partial FMRI argumentsClosedAndy Fiddaman2017-09-28

Actions
Actions #1

Updated by Andy Fiddaman almost 5 years ago

  • Related to Bug #8688: svcadm does not handle multiple partial FMRI arguments added
Actions #2

Updated by Electric Monk almost 5 years ago

  • Status changed from New to Closed
  • % Done changed from 0 to 100

git commit ad3ad82ad2fb99c424a8482bd1908d08b990ccea

commit  ad3ad82ad2fb99c424a8482bd1908d08b990ccea
Author: Andy Fiddaman <omnios@citrus-it.net>
Date:   2017-10-18T20:16:11.000Z

    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>
    Reviewed by: Chris Fraire <cfraire@me.com>
    Reviewed by: Jerry Jelinek <jerry.jelinek@joyent.com>
    Approved by: Robert Mustacchi <rm@joyent.com>

Actions

Also available in: Atom PDF