← Back to branch summary

~ubuntu-branches/debian/experimental/parted/experimental

« back to all changes in this revision

Viewing changes to doc/parted.info

  • Committer: Bazaar Package Importer
  • Author(s): Otavio Salvador, Otavio Salvador, Colin Watson, Xavier Oswald, Xavier Oswald, Colin Watson
  • Date: 2010-02-06 16:39:19 UTC
  • mfrom: (1.1.4 upstream) (7.1.3 squeeze)
  • Revision ID: james.westby@ubuntu.com-20100206163919-rt7jssmitulmp010
Tags: 2.1-1
http://bugs.debian.org/553824
http://bugs.debian.org/497626
http://bugs.debian.org/487833
http://bugs.debian.org/557044
* New upstream release

[ Otavio Salvador ]
* control.in: bump preferred soname for libreadline (closes: #553824).

[ Colin Watson ]
* control.in: Remove copy-and-paste error from libparted1.8-i18n
  description (closes: #497626).
* copyright: Document parted.info's licence, namely GFDL 1.1 with no
  invariant sections, front-cover texts, or back-cover texts (closes:
  #500201).
* rules: Cell partition tables are misdetected as pc98, so disable pc98
  support on powerpc (closes: #487833).
* control.in: Don't build-depend on libdevmapper-dev on hurd-i386.
* control.in: Build-depend on libdevmapper-dev (>= 1.02.33), for
  dm_task_set_major_minor.

[ Xavier Oswald ]
* debian/control.in: 
  - Change my mail address
  - Bump Standards-Version to 3.8.3
  - Update Build-Depends on debhelper 7
* debian/compat: update version to 7
* Parted not informing the kernel of changes to the partition table 
  (Closes: #557044), fixed upstream

[ Otavio Salvador ]
* debian/watch: fix URL to download
* Switch to quilt to manage patches
  - unpartitioned-disks.dpatch, drop (merged upstream)
  - unblacklist-md.dpatch, drop (merged upstream)
  - amiga-raid-lvm-fix.dpatch, drop (not used for ages)
  - devfs.dpatch, drop (devfs is not used)
  - reiserfs-libname.dpatch, drop (referenced library is unavailable)

[ Xavier Oswald, Colin Watson ]
* Refresh update-ext4-code.patch

[ Otavio Salvador ]
* Fix parted-doc info files installation
* Add lintian overrides for parted package
* Use soname in libparted udeb name

Show diffs side-by-side

added added

removed removed

Lines of Context:
doc/parted.info
1
 
This is ../../doc/parted.info, produced by makeinfo version 4.8 from
2
 
../../doc/parted.texi.
 
1
This is parted.info, produced by makeinfo version 4.13 from parted.texi.
3
2
 
4
 
  This file documents the use of GNU Parted, a program for creating,
 
3
This file documents the use of GNU Parted, a program for creating,
5
4
resizing, checking and copy partitions and file systems on them.
6
5
 
7
 
  Copyright (C) 1999, 2000, 2001, 2002, 2003, 2004, 2005, 2006, 2007
8
 
Free Software Foundation, Inc.
 
6
  Copyright (C) 1999-2009 Free Software Foundation, Inc.
9
7
 
10
8
  Permission is granted to copy, distribute and/or modify this document
11
9
under the terms of the GNU Free Documentation License, Version 1.1 or
28
26
destroying, resizing, checking and copying hard drive partitions, and
29
27
the file systems on them.
30
28
 
31
 
  This document applies roughly to version *1.8.7* of GNU Parted.
 
29
  This document applies roughly to version *2.1* of GNU Parted.
32
30
 
33
31
  The original version was written by Andrew Clausen in text format.
34
32
Richard M. Kreuter translated it into Texinfo format in 2002, to be
363
361
 
364
362
  Numbers indicating partition locations can be whole numbers or
365
363
decimals.  The suffix selects the unit, which may be one of those
366
 
described in *Note unit::, except CHS and compact.  If no suffix is
 
364
described in *note unit::, except CHS and compact.  If no suffix is
367
365
given, then the default unit is assumed.  Negative numbers count back
368
366
from the end of the disk, with "-1s" indicating the end of the disk.
369
367
Parted will compute sensible ranges for the locations you specify (e.g.
390
388
the calculated values differ too much, Parted will ask you for
391
389
confirmation.
392
390
 
 
391
  Currently ext3 filesystem functionality does not work. To manage ext3
 
392
type filesystems use tools like resize2fs or mke2fs.  Note that the
 
393
currently supported ext2 filesystem will be deprecated once ext3
 
394
support is finalized.  Further note that ext3 support will have limited
 
395
functionality that is yet to be defined.  Use tools like resize2fs (8)
 
396
and mke2fs (8) to manage these types of filesystems.
 
397
 
393
398
 
394
399
File: parted.info,  Node: Invoking Parted,  Next: Command explanations,  Prev: Running Parted,  Up: Using Parted
395
400
 
402
407
     # parted [OPTION] DEVICE [COMMAND [ARGUMENT]]
403
408
 
404
409
  Available options and commands follow.  For detailed explanations of
405
 
the use of Parted commands, see *Note Command explanations::. Options
 
410
the use of Parted commands, see *note Command explanations::. Options
406
411
begin with a hyphen, commands do not:
407
412
 
408
413
  Options:
411
416
`--help'
412
417
     display a help message
413
418
 
414
 
`-i'
415
 
`--interactive'
416
 
     prompt for user intervention
417
 
 
418
419
`-s'
419
420
`--script'
420
421
     never prompt the user
421
422
 
 
423
`-a alignment-type'
 
424
`--align alignment-type'
 
425
     Set alignment for newly created partitions, valid alignment types
 
426
     are: none, cylinder, minimal and optimal.
 
427
 
422
428
`-v'
423
429
`--version'
424
430
     display the version
433
439
 
434
440
* Menu:
435
441
 
 
442
* align-check::
436
443
* check::
437
444
* cp::
438
445
* help::
452
459
* unit::
453
460
 
454
461
 
455
 
File: parted.info,  Node: check,  Next: cp,  Up: Command explanations
456
 
 
457
 
2.4.1 check
 
462
File: parted.info,  Node: align-check,  Next: check,  Up: Command explanations
 
463
 
 
464
2.4.1 align-check
 
465
-----------------
 
466
 
 
467
 -- Command: align-check ALIGN-TYPE N
 
468
     Determine whether the starting sector of partition N meets the
 
469
     disk's selected alignment criteria.  ALIGN-TYPE must be `minimal',
 
470
     `optimal' or an abbreviation.  When in script mode, if the
 
471
     partition does not meet the alignment requirement, exit with
 
472
     status 1;  otherwise (including on older kernels for which
 
473
     alignment data is not available), continue processing any
 
474
     remaining commands.  Without `--script', print either `N aligned'
 
475
     or `N not aligned'.
 
476
 
 
477
     Example:
 
478
 
 
479
          (parted) align-check minimal 1
 
480
          1 aligned
 
481
 
 
482
 
 
483
 
 
484
File: parted.info,  Node: check,  Next: cp,  Prev: align-check,  Up: Command explanations
 
485
 
 
486
2.4.2 check
458
487
-----------
459
488
 
460
489
 -- Command: check NUMBER
469
498
 
470
499
File: parted.info,  Node: cp,  Next: help,  Prev: check,  Up: Command explanations
471
500
 
472
 
2.4.2 cp
 
501
2.4.3 cp
473
502
--------
474
503
 
475
504
 -- Command: cp [FROM-DEVICE] FROM-NUMBER TO-NUMBER
481
510
     specifies which device the source partition is on.
482
511
 
483
512
     Supported file systems:
484
 
        * ext2, ext3 (provided the destination partition is larger than
485
 
          the source partition)
 
513
        * ext2 (provided the destination partition is larger than the
 
514
          source partition)
486
515
 
487
516
        * fat16, fat32
488
517
 
502
531
 
503
532
File: parted.info,  Node: help,  Next: mklabel,  Prev: cp,  Up: Command explanations
504
533
 
505
 
2.4.3 help
 
534
2.4.4 help
506
535
----------
507
536
 
508
537
 -- Command: help [COMMAND]
517
546
 
518
547
File: parted.info,  Node: mklabel,  Next: mkfs,  Prev: help,  Up: Command explanations
519
548
 
520
 
2.4.4 mklabel
 
549
2.4.5 mklabel
521
550
-------------
522
551
 
523
552
 -- Command: mklabel LABEL-TYPE
558
587
 
559
588
File: parted.info,  Node: mkfs,  Next: mkpart,  Prev: mklabel,  Up: Command explanations
560
589
 
561
 
2.4.5 mkfs
 
590
2.4.6 mkfs
562
591
----------
563
592
 
564
593
 -- Command: mkfs NUMBER FS-TYPE
583
612
 
584
613
File: parted.info,  Node: mkpart,  Next: mkpartfs,  Prev: mkfs,  Up: Command explanations
585
614
 
586
 
2.4.6 mkpart
 
615
2.4.7 mkpart
587
616
------------
588
617
 
589
 
 -- Command: mkpart PART-TYPE [FS-TYPE] START END
 
618
 -- Command: mkpart [PART-TYPE FS-TYPE NAME] START END
590
619
     Creates a new partition, _without_ creating a new file system on
591
620
     that partition.  This is useful for creating partitions for file
592
621
     systems (or LVM, etc.) that Parted doesn't support.  You may
596
625
     are the offset from the beginning of the disk, that is, the
597
626
     "distance" from the start of the disk.
598
627
 
599
 
     PART-TYPE is one of: primary, extended, logical.  Extended and
600
 
     logical are only used for msdos and dvh disk labels.
 
628
     PART-TYPE is one of `primary', `extended' or `logical', and may be
 
629
     specified only with `msdos' or `dvh' partition tables.  A NAME
 
630
     must be specified for a `gpt' partition table.  Neither PART-TYPE
 
631
     nor NAME may be used with a `sun' partition table.
601
632
 
602
 
     FS-TYPE must be on of these supported file systems:
 
633
     FS-TYPE must be one of these supported file systems:
603
634
        * ext2
604
635
 
605
636
        * fat16, fat32
626
657
 
627
658
File: parted.info,  Node: mkpartfs,  Next: move,  Prev: mkpart,  Up: Command explanations
628
659
 
629
 
2.4.7 mkpartfs
 
660
2.4.8 mkpartfs
630
661
--------------
631
662
 
632
663
 -- Command: mkpartfs PART-TYPE FS-TYPE START END
634
665
     of type FS-TYPE on it.  The new partition will start START
635
666
     megabytes, and end END megabytes from the beginning of the disk.
636
667
     Do not use this command to recover a deleted partition (use mkpart
637
 
     instead).
 
668
     instead).  Using this command is discouraged.  Instead use mkpart
 
669
     to create an empty partition, and then use external tools like
 
670
     mke2fs (8) to create the filesystem.
638
671
 
639
672
     PART-TYPE is one of: primary, extended, logical.  Extended and
640
673
     logical are only used for msdos and dvh disk labels.
659
692
 
660
693
File: parted.info,  Node: move,  Next: name,  Prev: mkpartfs,  Up: Command explanations
661
694
 
662
 
2.4.8 move
 
695
2.4.9 move
663
696
----------
664
697
 
665
698
 -- Command: move NUMBER START END
671
704
     Move never changes the partition number.
672
705
 
673
706
     Supported file systems:
674
 
        * ext2, ext3 (provided the destination partition is larger than
675
 
          the source partition)
 
707
        * ext2 (provided the destination partition is larger than the
 
708
          source partition)
676
709
 
677
710
        * fat16, fat32
678
711
 
691
724
 
692
725
File: parted.info,  Node: name,  Next: print,  Prev: move,  Up: Command explanations
693
726
 
694
 
2.4.9 name
695
 
----------
 
727
2.4.10 name
 
728
-----------
696
729
 
697
730
 -- Command: name NUMBER NAME
698
731
     Sets the name for the partition NUMBER (GPT, Mac, MIPS and PC98
707
740
 
708
741
File: parted.info,  Node: print,  Next: quit,  Prev: name,  Up: Command explanations
709
742
 
710
 
2.4.10 print
 
743
2.4.11 print
711
744
------------
712
745
 
713
746
 -- Command: print [NUMBER]
734
767
 
735
768
File: parted.info,  Node: quit,  Next: rescue,  Prev: print,  Up: Command explanations
736
769
 
737
 
2.4.11 quit
 
770
2.4.12 quit
738
771
-----------
739
772
 
740
773
 -- Command: quit
749
782
 
750
783
File: parted.info,  Node: rescue,  Next: resize,  Prev: quit,  Up: Command explanations
751
784
 
752
 
2.4.12 rescue
 
785
2.4.13 rescue
753
786
-------------
754
787
 
755
788
 -- Command: rescue START END
794
827
 
795
828
File: parted.info,  Node: resize,  Next: rm,  Prev: rescue,  Up: Command explanations
796
829
 
797
 
2.4.13 resize
 
830
2.4.14 resize
798
831
-------------
799
832
 
800
833
 -- Command: resize NUMBER START END
805
838
     extended partition completely contains all logical partitions.
806
839
 
807
840
     Note that Parted can manipulate partitions whether or not they
808
 
     have been defragmented, so you do not need to defragmenting the
809
 
     disk before using Parted.
 
841
     have been defragmented, so you do not need to defragment the disk
 
842
     before using Parted.
810
843
 
811
844
     Supported file systems:
812
 
        * ext2, ext3 - restriction: the new START must be the same as
813
 
          the old START.
 
845
        * ext2 - restriction: the new START must be the same as the old
 
846
          START.
814
847
 
815
848
        * fat16, fat32
816
849
 
832
865
 
833
866
File: parted.info,  Node: rm,  Next: select,  Prev: resize,  Up: Command explanations
834
867
 
835
 
2.4.14 rm
 
868
2.4.15 rm
836
869
---------
837
870
 
838
871
 -- Command: rm NUMBER
858
891
 
859
892
File: parted.info,  Node: select,  Next: set,  Prev: rm,  Up: Command explanations
860
893
 
861
 
2.4.15 select
 
894
2.4.16 select
862
895
-------------
863
896
 
864
897
 -- Command: select DEVICE
876
909
 
877
910
File: parted.info,  Node: set,  Next: unit,  Prev: select,  Up: Command explanations
878
911
 
879
 
2.4.16 set
 
912
2.4.17 set
880
913
----------
881
914
 
882
915
 -- Command: set NUMBER FLAG STATE
884
917
     either "on" or "off".  Some or all of these flags will be
885
918
     available, depending on what disk label you are using:
886
919
 
 
920
    `bios_grub'
 
921
          (GPT) - Enable this to record that the selected partition is a
 
922
          GRUB BIOS partition.
 
923
 
887
924
    `boot'
888
925
          (Mac, MS-DOS, PC98) - should be enabled if you want to boot
889
926
          off the partition.  The semantics vary between disk labels.
938
975
 
939
976
File: parted.info,  Node: unit,  Prev: set,  Up: Command explanations
940
977
 
941
 
2.4.17 unit
 
978
2.4.18 unit
942
979
-----------
943
980
 
944
981
 -- Command: unit UNIT
1074
1111
 
1075
1112
                        Version 1.1, March 2000
1076
1113
 
1077
 
     Copyright (C) 2000 Free Software Foundation, Inc.
 
1114
     Copyright (C) 2000, 2009 Free Software Foundation, Inc.
1078
1115
     51 Franklin St, Fifth Floor, Boston, MA 02110-1301, USA
1079
1116
 
1080
1117
     Everyone is permitted to copy and distribute verbatim copies
1482
1519
[index]
1483
1520
* Menu:
1484
1521
 
 
1522
* align-check, command description:      align-check.           (line 6)
1485
1523
* bugs, reporting:                       Overview.              (line 6)
1486
1524
* building parted:                       Compiling.             (line 6)
1487
1525
* check, command description:            check.                 (line 6)
 
1526
* command description, align-check:      align-check.           (line 6)
1488
1527
* command description, check:            check.                 (line 6)
1489
1528
* command description, cp:               cp.                    (line 6)
1490
1529
* command description, help:             help.                  (line 6)
1557
1596
 
1558
1597
 
1559
1598
Tag Table:
1560
 
Node: Top822
1561
 
Node: Introduction1709
1562
 
Node: Overview2279
1563
 
Node: Software Required4324
1564
 
Node: Supported Platforms5683
1565
 
Node: License6399
1566
 
Node: Compiling7030
1567
 
Node: Static binaries8675
1568
 
Node: Using Parted10510
1569
 
Node: Partitioning10929
1570
 
Node: Running Parted11385
1571
 
Node: Invoking Parted13926
1572
 
Node: Command explanations14598
1573
 
Node: check14968
1574
 
Node: cp15247
1575
 
Node: help16184
1576
 
Node: mklabel16458
1577
 
Ref: mklabel-Footnote-117339
1578
 
Node: mkfs17468
1579
 
Node: mkpart17964
1580
 
Node: mkpartfs19227
1581
 
Node: move20207
1582
 
Node: name21094
1583
 
Node: print21470
1584
 
Node: quit22359
1585
 
Node: rescue22854
1586
 
Node: resize24379
1587
 
Node: rm25598
1588
 
Node: select26495
1589
 
Node: set26964
1590
 
Node: unit29005
1591
 
Node: Related information32553
1592
 
Node: Copying This Manual33376
1593
 
Node: GNU Free Documentation License33620
1594
 
Node: History53497
1595
 
Node: Index54294
 
1599
Node: Top758
 
1600
Node: Introduction1643
 
1601
Node: Overview2213
 
1602
Node: Software Required4258
 
1603
Node: Supported Platforms5617
 
1604
Node: License6333
 
1605
Node: Compiling6964
 
1606
Node: Static binaries8609
 
1607
Node: Using Parted10444
 
1608
Node: Partitioning10863
 
1609
Node: Running Parted11319
 
1610
Node: Invoking Parted14262
 
1611
Node: Command explanations15042
 
1612
Node: align-check15428
 
1613
Node: check16157
 
1614
Node: cp16456
 
1615
Node: help17387
 
1616
Node: mklabel17661
 
1617
Ref: mklabel-Footnote-118542
 
1618
Node: mkfs18671
 
1619
Node: mkpart19167
 
1620
Node: mkpartfs20577
 
1621
Node: move21723
 
1622
Node: name22604
 
1623
Node: print22982
 
1624
Node: quit23871
 
1625
Node: rescue24366
 
1626
Node: resize25891
 
1627
Node: rm27101
 
1628
Node: select27998
 
1629
Node: set28467
 
1630
Node: unit30629
 
1631
Node: Related information34177
 
1632
Node: Copying This Manual35000
 
1633
Node: GNU Free Documentation License35244
 
1634
Node: History55127
 
1635
Node: Index55924
1596
1636
 
1597
1637
End Tag Table