OSDN Git Service

tests: do not fail if some utilities are missing
[android-x86/external-parted.git] / README
1 GNU Parted
2 ----------
3
4 GNU Parted is a program for manipulating partition tables.
5
6 WARNING: USING PARTED TO PERFORM FILE SYSTEM OPERATIONS IS DEPRECATED
7 ---------------------------------------------------------------------
8
9 Parted retains (for now) the ability to create and modify a few types of
10 file systems, but that functionality is deprecated.  Whenever possible,
11 we recommend that you use file-system-specific tools to create and
12 operate on file systems.  For example, use the e2fsprogs programs
13 to operate on ext2, ext3 and ext4 file systems.  Use programs from
14 the reiserfsprogs package if you want to manipulate reiserfs file
15 systems.  Although Parted lets you do some of the same things, the
16 file-system-related code in parted is not as robust as the code in
17 more specialized, FS-specific packages.
18
19 So far, we have good arguments for retaining the capability to resize
20 FAT and HFS file systems: as far as we know, no other free software
21 provides that functionality.  However, all other FS-related functionality
22 will be removed from an upcoming release of Parted.  Thus, you should
23 now avoid using the following commands: mkpartfs, mkfs, cp, move, check
24 since support for them will be removed.
25
26
27 See the file NEWS for a list of major changes in the current release.
28
29
30  * documentation is in the doc/ directory.  The User's documentation is in
31 texinfo format, and is built into a format viewable by info/pinfo when
32 you run make.  To view the distributed texinfo documentation, run this:
33
34         $ info -f parted.info
35
36 Or view it on-line at:
37
38   http://www.gnu.org/software/parted/manual/parted.html
39
40  * the GNU Parted home page is http://www.gnu.org/software/parted
41  * the GNU Parted FAQ can be found at
42    http://www.gnu.org/software/parted/faq.html
43  * send bug reports, requests for help, feature requests, comments, etc. to
44    bug-parted@gnu.org.
45
46 For any copyright year range specified as YYYY-ZZZZ in this package
47 note that the range specifies every single year in that closed interval.
48
49
50 NOTE TO DISTRIBUTIONS
51 ---------------------
52
53 (1) When compiling Parted for distribution for general use, we recommend using
54 the default configuration:
55
56         CFLAGS=-Os ./configure
57
58 This includes --enable-debug (by default), which contains many assertions.
59 Obviously, these "waste" space, but in the past, they have caught potentially
60 dangerous bugs before they would have done damage, so we think it's worth
61 it.  Also, it means we get more bug reports ;)
62
63
64 (2) When doing dependencies, remember that libreiserfs is a *soft* dependency,
65 so I guess that means Debian-look-alikes should do a "suggests", but
66 not a "requires".
67
68
69 (3) When space is important, we suggest --without-readline, --disable-shared,
70 and possibly --disable-nls and --disable-dynamic-loading.
71
72 If Parted is only going to be used for probing / discovery (and not
73 "editing"), there is a --enable-discovery-only and --disable-fs (when you're
74 only interested in partition tables).  Since it's readonly, --enable-debug
75 gains you nothing wrt safety, so use --disable-debug ;)  The "discover"
76 program is about 35k (gzipped) when compiled this way (not counting libc
77 and libuuid).