Bugzilla – Bug 5553
required parameters are marked as optional in installadm(1M) man page
Last modified: 2009-04-07 10:23:28 UTC
You need to log in before you can comment on or make changes to this bug.
I make it P2, nice to have it fixed for upcomming public AI previe release ! 1. For exampple command defintions show then parameters are optional, but text under it say required (and they are really required) installadm add [-m manifest] [-n svcname] installadm remove [-m manifest] [-n svcname] install amd-create client ... 2. Parameters in commands and desctipsions must follow up convention then required are on line and in destription on first place
Same errors are in OpenSolaris 2008.11 Automated Installer Guide, likks like copy pasted from same source.
Reclassifying this as a documentation bug.
I will correct this for next release. Barbara
-s <srcimage> is marked as optional in create-service both in man pages and usage section. It should be mandatory (i.e. remove brackets) man: installadm create-service [-d] [-u][-f bootfile] [-D DHCPserver] [-n svcname] [-i dhcp_ip_start] [-c count_of_ipaddr] [-s srcimage] targetdir usage: create-service [-d] [-u] [-f <bootfile>] [-D <DHCPserver>] [-n <svcname>] [-i <dhcp_ip_start>] [-c <count_of_ipaddr>] [-s <srcimage>] <targetdir>
(In reply to comment #4) > -s <srcimage> is marked as optional in create-service both in man pages and > usage section. > It should be mandatory (i.e. remove brackets) > After talking to Sue, she pointed out that '-s' is not mandatory, but optional and 'usage' as well as SYNOPSIS section in man page are correct. It is not quite obvious by looking at installadm(1M) man page and this should be clarified, as man page mentions in SUBCOMMANDS AND OPTIONS section: ... Publishes the OSInstall service. Only a source image and a target directory are required for basic setup. ... -s srcimage Required: Specifies location of source image to use for setting up OSInstall service. ...
Fixed in online man page copy, ready for delivery to engineering build.