Warning, /system/partitionmanager/doc/glossary.docbook is written in an unsupported language. File is not indexed.

0001 <glossary id="glossary">
0002 
0003         <glossentry id="glossary-command">
0004                 <glossterm>Command</glossterm>
0005                 <glossdef>
0006                         <para>
0007                                 In &partman; commands are what <link linkend="glossary-job">jobs</link> are made up of. These are very low level steps being taken, often executed by an external tool, and only visible in the detailed progress report.
0008                         </para>
0009                         <para>
0010                                 The user normally does not have to bother with commands at all.
0011                         </para>
0012                         <glossseealso otherterm="glossary-operation"/>
0013                         <glossseealso otherterm="glossary-job"/>
0014                 </glossdef>
0015         </glossentry>
0016         
0017         <glossentry id="glossary-cylinder">
0018                 <glossterm>Cylinder</glossterm>
0019                 <glossdef>
0020                         <para>
0021                                 A unit used to divide up a <link linkend="glossary-device">device</link>. Some operating systems and many disk tools require <link linkend="glossary-partition">partitions</link> to begin and end on a cylinder. &partman; therefore automatically snaps partitions to cylinder boundaries when changing their start or end.
0022                         </para>
0023                         <glossseealso otherterm="glossary-head"/>
0024                         <glossseealso otherterm="glossary-sector"/>
0025                 </glossdef>
0026         </glossentry>
0027         
0028         <glossentry id="glossary-cylindersize">
0029                 <glossterm>Cylinder Size</glossterm>
0030                 <glossdef>
0031                         <para>
0032                                 The number of <link linkend="glossary-sector">sectors</link> per <link linkend="glossary-cylinder">cylinder</link> on a <link linkend="glossary-device">device</link>. Calculated as the number of <link linkend="glossary-head">heads</link> multiplied by the number of <link linkend="glossary-sector">sectors</link> per track.
0033                         </para>
0034                 </glossdef>
0035         </glossentry>
0036         
0037         <glossentry id="glossary-device">
0038                 <glossterm>Device</glossterm>
0039                 <glossdef>
0040                         <para>
0041                                 A physical disk device. Physical disk devices are divided into logical sections called <link linkend="glossary-partition">partitions</link> with the use of <link linkend="glossary-partitiontable">partition tables</link>.
0042                         </para>
0043                 </glossdef>
0044         </glossentry>
0045 
0046         <glossentry id="glossary-disklabel">
0047                 <glossterm>Disk Label</glossterm>
0048                 <glossdef>
0049                         <para>
0050                                 Another name for a <link linkend="glossary-partitiontable">partition table</link> stemming from the SUN/BSD world.
0051                         </para>
0052                         <para>
0053                                 <note>
0054                                         <para>
0055                                                 They are easy to mix up, but a disk label has nothing to do with a <link linkend="glossary-filesystemlabel">file system label</link>.
0056                                         </para>
0057                                         <para>
0058                                                 See <ulink url="http://en.wikipedia.org/wiki/BSD_disklabel">this Wikipedia entry</ulink> for details on the name.
0059                                         </para>
0060                                 </note>
0061                         </para>
0062                         <glossseealso otherterm="glossary-partitiontable"/>
0063                 </glossdef>
0064         </glossentry>
0065 
0066         <glossentry id="glossary-extendedpartition">
0067                 <glossterm>Extended Partition</glossterm>
0068                 <glossdef>
0069                         <para>
0070                                 A <link linkend="glossary-partition">partition</link> that contains other partitions. Extended partitions can only be <link linkend="glossary-primarypartition">primary partitions</link> themselves. Whether extended partitions are available or not depends on the <link linkend="glossary-partitiontable">partition table</link> type used. MS-DOS partition tables allow one extended partition per <link linkend="glossary-device">device</link>.
0071                         </para>
0072                         <glossseealso otherterm="glossary-primarypartition"/>
0073                         <glossseealso otherterm="glossary-logicalpartition"/>
0074                 </glossdef>
0075         </glossentry>
0076 
0077         <glossentry id="glossary-filesystem">
0078                 <glossterm>File System</glossterm>
0079                 <glossdef>
0080                         <para>
0081                                 A file system defines how the storage of data (files with their metadata, folders and their metadata, free space) is organized within a <link linkend="glossary-partition">partition</link>. There are various different types of file systems, some coming originally from the Unix/Linux world, some not. Examples for commonly used file systems on Unix/Linux are Btrfs, ext4 and XFS.
0082                         </para>
0083                 </glossdef>
0084         </glossentry>
0085 
0086         <glossentry id="glossary-filesystemlabel">
0087                 <glossterm>File System Label</glossterm>
0088                 <glossdef>
0089                         <para>
0090                                 A title of a file system. Some file systems (among them Btrfs, ext2/3/4, FAT16/32 and NTFS) support setting a label for the file system so it can be identified in tools like &partman; or other applications.
0091                         </para>
0092                         <para>
0093                                 <note>
0094                                         <para>They are easy to mix up, but a file system label has nothing to do with a <link linkend="glossary-disklabel">disk label</link>.</para>
0095                                 </note>
0096                         </para>
0097                 </glossdef>
0098         </glossentry>
0099         
0100         <glossentry id="glossary-flag">
0101                 <glossterm>Flag</glossterm>
0102                 <glosssee otherterm="glossary-partitionflag"/>
0103         </glossentry>
0104         
0105         <glossentry>
0106                 <glossterm>GPT</glossterm>
0107                 <glossdef>
0108                         <para>A modern partition table format supported by most modern computers and operating systems. It supports more than 4 <link linkend="glossary-primarypartition">primary partitions</link> unlike older MS-DOS partition table.
0109                         </para>
0110                 </glossdef>
0111         </glossentry>
0112 
0113         <glossentry id="glossary-head">
0114                 <glossterm>Head</glossterm>
0115                 <glossdef>
0116                         <para>
0117                                 A unit used to divide up a <link linkend="glossary-device">device</link>.
0118                         </para>
0119                         <glossseealso otherterm="glossary-cylinder"/>
0120                         <glossseealso otherterm="glossary-sector"/>
0121                 </glossdef>
0122         </glossentry>
0123 
0124         <glossentry id="glossary-job">
0125                 <glossterm>Job</glossterm>
0126                 <glossdef>
0127                         <para>
0128                                 In &partman; a number of jobs is what <link linkend="glossary-operation">operations</link> are made up of. You normally do not have to bother with jobs at all; it only becomes apparent when applying the list of pending operations: &partman; will then show a progress dialog that is made up of all operations and their jobs and show which operation and which job is currently being executed.
0129                         </para>
0130                         <glossseealso otherterm="glossary-operation"/>
0131                         <glossseealso otherterm="glossary-command"/>
0132                 </glossdef>
0133         </glossentry>
0134 
0135         <glossentry id="glossary-label">
0136                 <glossterm>Label</glossterm>
0137                 <glossdef>
0138                         <para>
0139                                 Either a <link linkend="glossary-disklabel">disk label</link> or a <link linkend="glossary-filesystemlabel">file system label</link>.
0140                         </para>
0141                         <glossseealso otherterm="glossary-disklabel"/>
0142                         <glossseealso otherterm="glossary-filesystemlabel"/>
0143                 </glossdef>
0144         </glossentry>
0145         
0146         <glossentry id="glossary-logicalpartition">
0147                 <glossterm>Logical Partition</glossterm>
0148                 <glossdef>
0149                         <para>
0150                                 A <link linkend="glossary-partition">partition</link> inside an <link linkend="glossary-extendedpartition">extended partition</link>.
0151                         </para>
0152                         <glossseealso otherterm="glossary-primarypartition"/>
0153                         <glossseealso otherterm="glossary-extendedpartition"/>
0154                 </glossdef>
0155         </glossentry>
0156 
0157         <glossentry id="glossary-luks">
0158                 <glossterm>LUKS</glossterm>
0159                 <glossdef>
0160                         <para>Linux Unified Key Setup is the standard encryption format for Linux.
0161                         </para>
0162                 </glossdef>
0163         </glossentry>
0164 
0165         <glossentry id="glossary-lvm">
0166                 <glossterm>LVM</glossterm>
0167                 <glossdef>
0168                         <para>LVM is a system for managing logical partitions that is more flexible than normal partitions. It consists of three main components:</para>
0169                         <simplelist>
0170                         <member>LVM physical volumes are partitions on the disk whose space is managed by LVM.</member>
0171                         <member>LVM volume group is a collection of LVM physical volumes that can be partitioned into logical partitions. It might be used to create file systems spanning over multiple devices or to split encrypted <link linkend="glossary-luks">LUKS</link> volume into smaller partitions.</member>
0172                         <member>LVM logical volumes are similar to normal partitions except that they reside on LVM volume group. Also, the location of LVM logical partitions does not matter and they do not have to be physically contiguous. Therefore, &partman; does not allow to move LVM logical volumes and displays the remaining free space at the end of the device.</member>
0173                         </simplelist>
0174                 </glossdef>
0175         </glossentry>
0176 
0177         <glossentry id="glossary-operation">
0178                 <glossterm>Operation</glossterm>
0179                 <glossdef>
0180                         <para>
0181                                 &partman; divides the work it does into operations, <link linkend="glossary-job">jobs</link> and <link linkend="glossary-command">commands</link>.
0182                         </para>
0183                         <para>
0184                                 Operations are the most visible of the three. If you pick an action in the graphical user interface, this will likely result in a new operation being added to the list of pending operations. The idea behind that is: You will most probably want to set up quite a number of steps to transform the current state of your disk devices to the state you have in mind. Some of these steps may take quite a long time to execute (like copying a large file system or resizing a file system that is nearly full). To save you from having to sit in front of your computer for a long time waiting for one step to finish and then starting the next one, operations allow you to exactly specify how the computer's devices should look like once everything is finished, then let &partman; apply the operations and come back when it has executed all of them.
0185                         </para>
0186                         <para>
0187                                 Operations are kept in a list of pending operations. As long as an operation has not been applied it can still be <link linkend="menu-edit-undo">taken back easily</link> and nothing will have been modified.
0188                         </para>
0189                         <glossseealso otherterm="glossary-job"/>
0190                         <glossseealso otherterm="glossary-command"/>
0191                 </glossdef>
0192         </glossentry>
0193 
0194         <glossentry id="glossary-partition">
0195                 <glossterm>Partition</glossterm>
0196                 <glossdef>
0197                         <para>
0198                                 A section of a <link linkend="glossary-device">hard disk device</link> that can hold a <link linkend="glossary-filesystem">file system</link> or other partitions. Without at least one valid partition, a disk can not be used.
0199                         </para>
0200                         <glossseealso otherterm="glossary-device"/>
0201                         <glossseealso otherterm="glossary-partitiontable"/>
0202                         <glossseealso otherterm="glossary-primarypartition"/>
0203                         <glossseealso otherterm="glossary-extendedpartition"/>
0204                         <glossseealso otherterm="glossary-logicalpartition"/>
0205                 </glossdef>
0206         </glossentry>
0207 
0208         <glossentry id="glossary-partitionflag">
0209                 <glossterm>Partition Flag</glossterm>
0210                 <glossdef>
0211                         <para>
0212                                 A marker for a <link linkend="glossary-partition">partition</link>. The availability of these flags depends on the type of <link linkend="glossary-partitiontable">partition table</link> used.
0213                         </para>
0214                 </glossdef>
0215         </glossentry>
0216         
0217         <glossentry id="glossary-partitiontable">
0218                 <glossterm>Partition Table</glossterm>
0219                 <glossdef>
0220                         <para>
0221                                 A small section at the beginning of a <link linkend="glossary-device">device</link> used to store information about the layout of the device's <link linkend="glossary-partition">partitions</link>. There are different types of partition tables, each with their own limitations.
0222                         </para>
0223                         <para>
0224                                 Sometimes also referred to as <quote>disk label</quote>.
0225                         </para>
0226                 </glossdef>
0227         </glossentry>
0228 
0229         <glossentry id="glossary-primarypartition">
0230                 <glossterm>Primary Partition</glossterm>
0231                 <glossdef>
0232                         <para>
0233                                 A <link linkend="glossary-partition">partition</link> directly inside a <link linkend="glossary-partitiontable">partition table</link>, as opposed to <link linkend="glossary-logicalpartition">logical partitions</link>, which are in <link linkend="glossary-extendedpartition">extended partitions</link>.
0234                         </para>
0235                         <para>
0236                                 <link linkend="glossary-partitiontable">Partition tables</link> usually impose restrictions on the maximum number of primary partitions that can be created on a <link linkend="glossary-device">device</link>. For MS-DOS type partition tables, for example, this maximum number is four.
0237                         </para>
0238                         <glossseealso otherterm="glossary-extendedpartition"/>
0239                         <glossseealso otherterm="glossary-logicalpartition"/>
0240                 </glossdef>
0241         </glossentry>
0242 
0243         <glossentry id="glossary-sector">
0244                 <glossterm>Sector</glossterm>
0245                 <glossdef>
0246                         <para>
0247                                 A unit used to divide up a <link linkend="glossary-device">device</link>. <link linkend="glossary-partition">Partitions</link> must always begin and end on a sector.
0248                         </para>
0249                         <glossseealso otherterm="glossary-head"/>
0250                         <glossseealso otherterm="glossary-cylinder"/>
0251                 </glossdef>
0252         </glossentry>
0253         
0254         <glossentry id="glossary-sectorsize">
0255                 <glossterm>Sector Size</glossterm>
0256                 <glossdef>
0257                         <para>
0258                                 The number of bytes per <link linkend="glossary-sector">sector</link> on a <link linkend="glossary-device">device</link>. The sector size of most devices in use today is 512 bytes.
0259                         </para>
0260                 </glossdef>
0261         </glossentry>
0262         
0263         <!--
0264                 <glossentry>
0265                         <glossterm></glossterm>
0266                         <glossdef>
0267                                 <para>
0268                                 </para>
0269                         </glossdef>
0270                 </glossentry>
0271                 -->
0272 
0273 </glossary>