Frank Ludolph wrote:
> Ethan Quach wrote:
>>
>>
>> Frank Ludolph wrote:
>>> OK, but I'm still concerned that the commands be easy to remember. A
>>> user shouldn't have to remember whether <svcname> requires -n in one
>>> command, but not in another.
>>>
>>> One alternative is that there are no operands, only options. But
>>> "installadm start -n <svcname>" seems a little overkill. Still, it
>>> would be acceptable.
>>>
>>> Another alternative would be: if a subcommand has only one required
>>> option and no optional options, e.g. start <svcname>, that option
>>> should be an operand. Subcommands having multiple options, whether
>>> required or not, have only options and no operands. A slightly more
>>> complex rule to learn, but not too likely to err.
>>>
>>> I feel either is acceptable.
>>
>> I like the second alternative. But optional option flags should be
>> okay right? e.g.
>>
>> installadm list
>> installadm list serviceFoo
>> installadm list -m
>> installadm list -m serviceFoo
>>
> "Installadm list -m" should not be allowed. CLIP guideline #7 says that
> option arguments should not be optional.
Okay, agreed on this.
> Could you send me the proposed
> syntax for installadm list so that I can review it more carefully?
This is the proposed syntax:
installadm list [ [-m] <svcname> | -c | -r ]
Lists information about the install services that have
been setup on this system. Information for all install
services will given if a specific svcname is not provided.
With the '-m' option, manifest information will also be
given, but can only be used when a specific svcname is
provided. The '-c' option will list all clients that
have been created on this server. The '-r' option will
list information for remote install services in addition
to the local ones.
-m svcname Lists all manifest information, including
the manifest criteria, for the install
service specified.
-c Lists all clients that have been created
on this server, and the install service
and imagepath used with each client.
-r Lists basic information for remote
services as well as local services.
thanks,
-ethan
