svcadm manpage needs more 5021-related updates
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.
Updated by Electric Monk almost 5 years ago
- Status changed from New to Closed
- % Done changed from 0 to 100
commit ad3ad82ad2fb99c424a8482bd1908d08b990ccea Author: Andy Fiddaman <email@example.com> 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 <firstname.lastname@example.org> Reviewed by: Chris Fraire <email@example.com> Reviewed by: Jerry Jelinek <firstname.lastname@example.org> Approved by: Robert Mustacchi <email@example.com>