Bug 107294 - clearpart documentation misleading
Summary: clearpart documentation misleading
Keywords:
Status: CLOSED NEXTRELEASE
Alias: None
Product: Fedora
Classification: Fedora
Component: anaconda
Version: rawhide
Hardware: All
OS: Linux
medium
medium
Target Milestone: ---
Assignee: Jeremy Katz
QA Contact: Mike McLean
URL:
Whiteboard:
Depends On:
Blocks: 123819
TreeView+ depends on / blocked
 
Reported: 2003-10-16 16:32 UTC by Rik Faith
Modified: 2007-11-30 22:10 UTC (History)
3 users (show)

Fixed In Version:
Clone Of:
Environment:
Last Closed: 2005-02-03 20:07:51 UTC
Type: ---
Embargoed:


Attachments (Terms of Use)

Description Rik Faith 2003-10-16 16:32:19 UTC
From Bugzilla Helper:
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.0.1) Gecko/20021003

Description of problem:
The clearpart documentation in
file:///usr/share/doc/anaconda-9.0.93/kickstart-docs.html is misleading.  It states:

    For example, the following clears the partitions on the first two 
    drives on the primary IDE controller:

    clearpart --drives hda,hdb

This may have been true at one time, but now the default is CLEARPART_TYPE_NONE,
so this will do nothing.  I suggest you change this example to:

    clearpart --drives=hda,hdb --all

or

    clearpart --drives=hda,hdb --linux

(Note the = which makes the example consistent with the syntax used in the
earlier part of the documentation.)

Version-Release number of selected component (if applicable):
anaconda-9.0.93-1

How reproducible:
Always

Steps to Reproduce:
Kickstart on already partitioned drive with clearpart --drives=hda


Actual Results:  Error message (reproduced here:
http://www.bohnsack.com/lists/archives/xcat-user/1457.html), because anaconda
can't add more partitions, since none were removed.

At this point, an fdisk -l will also show all the old paritions.

This is not expected behavior based on the example in the documentation.

Expected Results:  Cleared partitions and successful kickstart.

Additional info:

Success is obtained with clearpart --drives=hda --all

Comment 1 Tammy Fox 2004-02-27 06:10:43 UTC
This comes from the kickstart docs in the SAG. The SAG doc needs to be
fixed and then redumped to kickstart-docs.html and kickstart-docs.txt
for the anaconda package. Reassigning to new owner.

Comment 2 Andrius Benokraitis 2005-02-02 21:17:12 UTC
Sounds good... this will be updated in the SAG for the next release,
which will be RHEL4. Unless the developer for anaconda disagrees! :-)

Reassigning to developer who owns ananconda to update the man page.

Comment 10 Andrius Benokraitis 2005-02-03 20:07:51 UTC
Bug suggestion reviewed and approved for addition into the RHEL4-SAG.
Propogation to the /usr/share/doc/anaconda-*/kickstart-docs.html file
may come later, during a future RHEL4 Update.

Thanks for submitting the bug! :-)

Andrius.


Note You need to log in before you can comment on or make changes to this bug.