source: xsoft/other/gparted.xml@ f1ce80b

10.0 10.1 11.0 7.10 8.0 8.1 8.2 8.3 8.4 9.0 9.1 basic bdubbs/svn elogind ken/refactor-virt lazarus nosym perl-modules qt5new trunk xry111/git-date xry111/git-date-for-trunk xry111/git-date-test
Last change on this file since f1ce80b was f1ce80b, checked in by DJ Lucas <dj@…>, 5 years ago

[systemd-merge] - Section II layout

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@17433 af4574ff-66df-0310-9fd7-8a98e5e911e0

  • Property mode set to 100644
File size: 10.4 KB
Line 
1<?xml version="1.0" encoding="ISO-8859-1"?>
2<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
3 "http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
4 <!ENTITY % general-entities SYSTEM "../../general.ent">
5 %general-entities;
6
7 <!ENTITY gparted-download-http
8 "&sourceforge-repo;/gparted/gparted-&gparted-version;.tar.gz">
9 <!ENTITY gparted-download-ftp " ">
10 <!ENTITY gparted-md5sum "4980fa2b7acf591c53d8c5aecd633306">
11 <!ENTITY gparted-size "3.1 MB">
12 <!ENTITY gparted-buildsize "84 MB">
13 <!ENTITY gparted-time "1.3 SBU">
14]>
15
16<sect1 id="gparted" xreflabel="Gparted-&gparted-version;">
17 <?dbhtml filename="gparted.html"?>
18
19 <sect1info>
20 <othername>$LastChangedBy$</othername>
21 <date>$Date$</date>
22 </sect1info>
23
24 <title>Gparted-&gparted-version;</title>
25
26 <indexterm zone="gparted">
27 <primary sortas="a-Gparted">Gparted</primary>
28 </indexterm>
29
30 <sect2 role="package">
31 <title>Introduction to Gparted</title>
32
33 <para>
34 Gparted is the Gnome Partition Editor, a Gtk 2 GUI for other command line
35 tools that can create, reorganise or delete disk partitions.
36 </para>
37
38 &lfs79_checked;
39
40 <bridgehead renderas="sect3">Package Information</bridgehead>
41 <itemizedlist spacing="compact">
42 <listitem>
43 <para>
44 Download (HTTP): <ulink url="&gparted-download-http;"/>
45 </para>
46 </listitem>
47 <listitem>
48 <para>
49 Download (FTP): <ulink url="&gparted-download-ftp;"/>
50 </para>
51 </listitem>
52 <listitem>
53 <para>
54 Download MD5 sum: &gparted-md5sum;
55 </para>
56 </listitem>
57 <listitem>
58 <para>
59 Download size: &gparted-size;
60 </para>
61 </listitem>
62 <listitem>
63 <para>
64 Estimated disk space required: &gparted-buildsize;
65 </para>
66 </listitem>
67 <listitem>
68 <para>
69 Estimated build time: &gparted-time;
70 </para>
71 </listitem>
72 </itemizedlist>
73
74 <bridgehead renderas="sect3">Gparted Dependencies</bridgehead>
75
76 <bridgehead renderas="sect4">Required</bridgehead>
77 <para role="required">
78 <xref linkend="gtkmm2"/> and
79 <xref linkend="parted"/>
80 </para>
81
82 <bridgehead renderas="sect4">Optional</bridgehead>
83 <para role="optional">
84 <ulink url="&gnome-download-http;/gnome-doc-utils/">
85 GNOME Doc Utils</ulink> and
86 <xref linkend="rarian"/>
87 </para>
88
89 <para condition="html" role="usernotes">
90 User Notes: <ulink url="&blfs-wiki;/gparted"/>
91 </para>
92 </sect2>
93
94 <sect2 role="installation">
95 <title>Installation of Gparted</title>
96
97 <para>
98 Install <application>Gparted</application> by running the following
99 commands:
100 </para>
101
102<screen><userinput>./configure --prefix=/usr \
103 --disable-doc \
104 --disable-static &amp;&amp;
105make</userinput></screen>
106
107 <para>
108 This package does not come with a testsuite.
109 </para>
110
111 <para>
112 Now, as the <systemitem class="username">root</systemitem> user:
113 </para>
114
115<screen role="root"><userinput>make install</userinput></screen>
116
117 </sect2>
118
119 <sect2 role="commands">
120 <title>Command Explanations</title>
121
122 <xi:include xmlns:xi="http://www.w3.org/2001/XInclude"
123 href="../../xincludes/static-libraries.xml"/>
124
125 <para>
126 <option>--disable-doc</option>: This switch disables building of
127 the optional documentation. Remove it if you have installed
128 <application>GNOME Doc Utils</application>.
129 </para>
130
131 </sect2>
132
133 <sect2 role="using">
134 <title>Using Gparted</title>
135
136 <para>
137 To manipulate file systems Gparted has a run time dependency on various
138 file system tools (you only need to install the tools for file systems you
139 actually use):
140 <xref linkend="hdparm"/>
141 (required for optionally display serial number device information),
142 e2fsprogs (installed as part of LFS),
143 <xref linkend="jfsutils"/>,
144 <xref linkend="ntfs-3g"/>,
145 <xref linkend="reiserfs"/>,
146 <xref linkend="xfsprogs"/>,
147 <ulink url="https://btrfs.wiki.kernel.org/index.php/Btrfs_source_repositories">
148 btrfs-progs</ulink>,
149 <ulink url="http://www.daniel-baumann.ch/software/dosfstools/">dosfstools</ulink>,
150 <ulink url="http://ftp.gnu.org/pub/gnu/mtools/">mtools</ulink> (required
151 to read and write FAT16/32 volume labels and UUIDs),
152 <ulink url="ftp://ftp.mars.org/pub/hfs/">hfsutils</ulink>,
153 hfsprogs,
154 <ulink url="http://www.nilfs.org/download/">nilfs-utils</ulink> and
155 reiser4progs.
156 </para>
157
158 <para>
159 Root privileges are required to run Gparted. If you wish to run the
160 application from the menu, further applications and configurations are
161 necessary. Examples of applications that may be used:
162 <ulink url="http://people.debian.org/~kov/gksu">gksu</ulink>,
163 <ulink url="https://launchpad.net/kdesudo">kdesudo</ulink>, or
164 <ulink url="https://github.com/tarakbumba/xdg-su">xdg-su</ulink>.
165 Other solution is to use <application>pkexec</application>, from
166 <xref linkend="polkit"/>, but some configuration is necessary.
167 Another simple solution is <xref linkend="ssh-askpass"/>. Below, we
168 describe these two alternatives: "ssh-askpass" and "pkexec".
169 </para>
170
171 <sect3 role="ssh-askpass">
172 <title>ssh-askpass</title>
173 <para>
174 To optionally use <xref linkend="ssh-askpass"/> if it is installed in
175 your system, run the following commands as the
176 <systemitem class="username">root</systemitem> user:
177 </para>
178
179<screen role="root"><userinput>cp -v /usr/share/applications/gparted.desktop /usr/share/applications/gparted.desktop.back &amp;&amp;
180sed -i 's/Exec=/Exec=sudo -A /' /usr/share/applications/gparted.desktop</userinput></screen>
181
182 <para>
183 Now, clicking in the menu item for Gparted, a dialog appears in the
184 screen, asking for the administrator password.</para>
185
186 </sect3>
187
188 <sect3 role="pkexec" revision="sysv">
189 <title>pkexec</title>
190 <para>
191 To optionally use <application>pkexec</application>, you need <xref
192 linkend="polkit-gnome"/><!-- or <xref linkend="lxpolkit"/>-->, and
193 <xref linkend="consolekit"/> installed with support to <xref
194 linkend="linux-pam"/> and <xref linkend="polkit"/>. As the
195 <systemitem class="username">root</systemitem> user, configure <xref
196 linkend="gparted"/> and <xref linkend="polkit"/> with the following
197 commands:
198 </para>
199
200<screen role="root"><userinput>cp -v /usr/share/applications/gparted.desktop \
201 /usr/share/applications/gparted.desktop.back &amp;&amp;
202sed -i 's:/usr/sbin/gparted:/usr/sbin/gparted_polkit:' \
203 /usr/share/applications/gparted.desktop &amp;&amp;
204
205cat &gt; /usr/sbin/gparted_polkit &lt;&lt; "EOF" &amp;&amp;
206<literal>#!/bin/bash
207
208pkexec /usr/sbin/gparted $@</literal>
209EOF
210chmod -v 0755 /usr/sbin/gparted_polkit</userinput></screen>
211
212 <para>
213 Still as the <systemitem class="username">root</systemitem> user,
214 configure <xref linkend="polkit"/> and <xref linkend="gparted"/> to
215 use <application>pkexec</application>:
216 </para>
217
218<screen role="root"><userinput>cat &gt; /usr/share/polkit-1/actions/org.gnome.gparted.policy &lt;&lt; "EOF"
219<literal>&lt;?xml version="1.0" encoding="UTF-8"?&gt;
220&lt;!DOCTYPE policyconfig PUBLIC
221 "-//freedesktop//DTD PolicyKit Policy Configuration 1.0//EN"
222 "http://www.freedesktop.org/standards/PolicyKit/1/policyconfig.dtd"&gt;
223&lt;policyconfig&gt;
224
225 &lt;action id="org.freedesktop.policykit.pkexec.run-gparted"&gt;
226 &lt;description&gt;Run GParted&lt;/description&gt;
227 &lt;message&gt;Authentication is required to run GParted&lt;/message&gt;
228 &lt;defaults&gt;
229 &lt;allow_any&gt;no&lt;/allow_any&gt;
230 &lt;allow_inactive&gt;no&lt;/allow_inactive&gt;
231 &lt;allow_active&gt;auth_admin_keep&lt;/allow_active&gt;
232 &lt;/defaults&gt;
233 &lt;annotate key="org.freedesktop.policykit.exec.path"&gt;/usr/sbin/gparted&lt;/annotate&gt;
234 &lt;annotate key="org.freedesktop.policykit.exec.allow_gui"&gt;true&lt;/annotate&gt;
235 &lt;/action&gt;
236
237&lt;/policyconfig&gt;</literal>
238EOF
239chmod -v 0644 /usr/share/polkit-1/actions/org.gnome.gparted.policy</userinput></screen>
240
241 <para>
242 Now, clicking in the menu item for Gparted, a dialog appears in the
243 screen, asking for the administrator password.</para>
244
245 </sect3>
246
247 </sect2>
248
249 <sect2 role="content">
250 <title>Contents</title>
251
252 <segmentedlist>
253 <segtitle>Installed Programs</segtitle>
254 <segtitle>Installed Libraries</segtitle>
255 <segtitle>Installed Directories</segtitle>
256
257 <seglistitem>
258 <seg>
259 gparted, gpartedbin and gparted_polkit (optional)
260 </seg>
261 <seg>
262 None
263 </seg>
264 <seg>
265 /usr/share/gnome/help/gparted and
266 /usr/share/omf/gparted
267 </seg>
268 </seglistitem>
269 </segmentedlist>
270
271 <variablelist>
272 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
273 <?dbfo list-presentation="list"?>
274 <?dbhtml list-presentation="table"?>
275
276 <varlistentry id="gparted-prog">
277 <term><command>gparted</command></term>
278 <listitem>
279 <para>
280 is a shell script which sets up the environment before calling
281 <command>gpartedbin</command>.
282 </para>
283 <indexterm zone="gparted gparted-prog">
284 <primary sortas="b-gparted">gparted</primary>
285 </indexterm>
286 </listitem>
287 </varlistentry>
288
289 <varlistentry id="gpartedbin">
290 <term><command>gpartedbin</command></term>
291 <listitem>
292 <para>
293 is the Gparted binary.
294 </para>
295 <indexterm zone="gparted gpartedbin">
296 <primary sortas="b-gpartedbin">gpartedbin</primary>
297 </indexterm>
298 </listitem>
299 </varlistentry>
300
301 <varlistentry id="gparted_polkit">
302 <term><command>gparted_polkit</command></term>
303 <listitem>
304 <para>
305 is an optional script which can be used to run gparted with polkit,
306 from a menu.
307 </para>
308 <indexterm zone="gparted gparted_polkit">
309 <primary sortas="b-gparted_polkit">gparted_polkit</primary>
310 </indexterm>
311 </listitem>
312 </varlistentry>
313
314 </variablelist>
315
316 </sect2>
317
318</sect1>
Note: See TracBrowser for help on using the repository browser.