docs/131370: geom_label needs clarification in docs

[Tim Judd]

>Number:         131370
>Category:       docs
>Synopsis:       geom_label needs clarification in docs
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Wed Feb 04 17:10:01 UTC 2009
>Closed-Date:
>Last-Modified:
>Originator:     Tim Judd
>Release:        7.1-RELEASE-p2
>Organization:
>Environment:
N/A
>Description:
After trying to alter a ufs label with glabel (and getting Operation not permitted and other nonhelpful errors), I realized that glabel will add/modify labels in the /dev/label/ directory.  I was trying to use glabel to clear a /dev/ufs/ label and it was refusing to do it.

I suggest modifying the g(eom_)label manpage to reflect that to alter a label, you must use the proper utility to make the change, for example:

mkisofs for iso9660
tunefs for ufs
glabel for label

And the rest as needed.  This will clarify that geom_label is only as a method, not a general purpose tool to alter all information.
>How-To-Repeat:
tunefs -L root /dev/ad0s1a        # creates /dev/ufs/root
glabel clear root                 # fails to clear /dev/ufs/root

tunefs -L "" /dev/ad0s1a          # clears /dev/ufs/root
>Fix:
See above, how to repeat


>Release-Note:
>Audit-Trail:
>Unformatted: