source: xsoft/other/gparted.xml@ 45ab6c7

11.0 qt5new trunk
Last change on this file since 45ab6c7 was 45ab6c7, checked in by Xi Ruoyao <xry111@…>, 5 months ago

more SVN prop clean up

Remove "$LastChanged$" everywhere, and also some unused $Date$

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