← Back to branch summary

~ubuntu-branches/ubuntu/utopic/gdisk/utopic-proposed

« back to all changes in this revision

Viewing changes to README

  • Committer: Bazaar Package Importer
  • Author(s): Guillaume Delacour
  • Date: 2009-12-01 21:04:25 UTC
  • Revision ID: james.westby@ubuntu.com-20091201210425-lznlvi764r2dwkf8
Tags: upstream-0.5.1
Import upstream version 0.5.1

Show diffs side-by-side

added added

removed removed

Lines of Context:
README
 
1
GPT fdisk (aka gdisk)
 
2
by Roderick W. Smith, rodsmith@rodsbooks.com
 
3
 
 
4
Introduction
 
5
------------
 
6
 
 
7
This software is intended as a (somewhat) fdisk-workalike program for
 
8
GPT-partitioned disks. Although libparted and programs that use it (GNU
 
9
Parted, gparted, etc.) provide the ability to handle GPT disks, they have
 
10
certain limitations that gdisk overcomes. Specific advantages of gdisk
 
11
include:
 
12
 
 
13
* The ability to convert MBR-partitioned disks in-place to GPT format,
 
14
  without losing data
 
15
 
 
16
* The ability to convert BSD disklabels in-place to create GPT
 
17
  partitions, without losing data
 
18
 
 
19
* The ability to specify sector-exact partition sizes
 
20
 
 
21
* More flexible specification of filesystem type code GUIDs, which
 
22
  GNU Parted tends to corrupt (particularly for FAT partitions)
 
23
 
 
24
* Clear identification of the number of unallocated sectors on a
 
25
  disk
 
26
 
 
27
* A user interface that's familiar to long-time users of Linux
 
28
  fdisk
 
29
 
 
30
* The MBR boot loader code is left alone (GNU Parted tends to
 
31
  wipe it out with every change)
 
32
 
 
33
* The ability to create a hybrid MBR, which permits GPT-unaware
 
34
  OSes to access up to three GPT partitions on the disk
 
35
 
 
36
Of course, gdisk isn't without its limitations. Most notably, it lacks the
 
37
filesystem awareness and filesystem-related features of GNU Parted. You
 
38
can't resize a partition's filesystem or create a partition with a
 
39
filesystem already in place with gdisk, for instance. There's no GUI
 
40
version of gdisk.
 
41
 
 
42
Installing
 
43
----------
 
44
 
 
45
To compile gdisk, you must have appropriate development tools installed,
 
46
most notably the GNU Compiler Collection (GCC) and its g++ compiler for
 
47
C++. Uncompress the package and type "make" at the command prompt in the
 
48
resulting directory. The result should be a program file called gdisk. You
 
49
can use this in place or copy the file to a suitable directory, such as
 
50
/usr/local/sbin. You can copy the man page (gdisk.8) to /usr/local/man/man8
 
51
to make it available.
 
52
 
 
53
Caveats
 
54
-------
 
55
 
 
56
THIS SOFTWARE IS EARLY BETA SOFTWARE! IF IT WIPES OUT YOUR HARD DISK OR
 
57
EATS YOUR CAT, DON'T BLAME ME! To date, I've tested the software mainly on
 
58
two USB flash drives, 2 GiB and 8 GiB in size. I've also made a few minor
 
59
tweaks to a production system with a 500 GiB hard disk and made more
 
60
extensive changes to a handful of 80-160 GiB hard disks. I believe all
 
61
data-corruption bugs to be squashed, but I know full well that the odds of
 
62
my missing something are high. This is particularly true for large drives;
 
63
I have no way of testing the software with > 2TiB drives, which will test
 
64
the 64-bit sector pointer support. I've received user reports of success
 
65
with >2TiB drives, though.
 
66
 
 
67
My main development platform is a system running the 64-bit version of
 
68
Ubuntu 8.04. I've also tested on 64-bit OpenSuSE, 32-bit Fedora 10, 32-bit
 
69
Ubuntu 6.10, 64-bit Gentoo, 32-bit PowerPC Linux, 32-bit Intel-based Mac
 
70
OS X, and 64-bit Fedora 7.1. Problems relating to 64-bit integers on the
 
71
32-bit Linux have been common during development and may crop up in the
 
72
future. The Mac OS X, FreeBSD, and big-endian (PowerPC) support are new.
 
73
 
 
74
Redistribution
 
75
--------------
 
76
 
 
77
This program is licensed under terms of the GNU GPL (see the file COPYING).
 
78
 
 
79
Acknowledgements
 
80
----------------
 
81
 
 
82
This code is mostly my own; however, I've used three functions from two
 
83
other GPLed programs:
 
84
 
 
85
- The code used to generate CRCs is taken from the efone program by
 
86
  Krzysztof Dabrowski and ElysiuM deeZine. (See the crc32.h and
 
87
  crc32.cc source code files.)
 
88
 
 
89
- A function to find the disk size is taken from Linux fdisk by
 
90
  A. V. Le Blanc.
 
91
 
 
92
Additional code contributors include:
 
93
 
 
94
- Yves Blusseau (1otnwmz02@sneakemail.com)
 
95
 
 
96
- David Hubbard (david.c.hubbard@gmail.com)