umountall -Z [PSARC/2008/765 FastTrack timeout 12/18/2008]

[Rich Brown]

On 12/12/08 06:23, Pavel Filipensky wrote:
> Hi Brian,
> 
> On 12/12/08 11:19, Brian Ruthven - Sun UK wrote:
>>
>> Is it ever likely to be useful to do "umountall -Z zonename" ?
> # zlogin zonename umountall
> is a way to do that
>> Perhaps to help release resources from a single zone, rather than 
>> having to umountall across all zones simultaneously?
>>
>> [ My thinking behind this is the recent change to lpstat where the -l 
>> flag suddenly started taking an additional parameter, and that broke 
>> all sorts of customer scripts which were used to the "lpstat -lp" 
>> command. I'd like to avoid a future incompatibility, but it depends on 
>> the expected target audience of this flag... ]
>>
>> Does this additional flag need to be added to the man page at all? 
>> Could it simply be a "private" flag? Is the -Z flag ever expected to 
>> be run by the average sysadmin on the command-line, or would it be 
>> confined to the zones stop method?
> -Z option might be interesting for experienced admins and for developers 
> - how they should get to know about the existence of that flag?
> -Z is proposed to be mentioned in 'Usage' as well:
> 
> # umountall -?
> Usage:
>        umountall [-k] [-s] [-F FSType] [-l|-r] [-Z] [-n]
>        umountall [-k] [-s] [-h host] [-Z] [-n]
> 
> Thanks,
> Pavel
>>
>> As long as the change to the default behaviour is noted (and frankly I 
>> would have expected umountall to operate in the current zone only 
>> anyway), and if the only place it is likely to be used is the zones 
>> stop method, I imagine the -Z could be an "undocumented" flag (cf. 
>> "savecore -m", only used in the bootup sequence).
>>
>> Thanks,
>> Brian
>>

In my opinion, adminstrative utilities with a system-wide effect, such
as umountall(1M), should have all of their options documented.  An
administrator may have a use for it or may simply want to know what
s/he just accidently did (oops!).  I don't see an advantage to make this
option private.

Unless there's a compelling reason to keep this private, then let's let
the proposal stand as a publicly documented option.

	Rich