← Back to branch summary

~ubuntu-branches/ubuntu/natty/xorg/natty-proposed

« back to all changes in this revision

Viewing changes to debian/local/dexconf.1

  • Committer: Bazaar Package Importer
  • Author(s): Bryce Harrington, Timo Aaltonen, Bryce Harrington
  • Date: 2011-04-01 00:05:38 UTC
  • mfrom: (6.3.15 sid)
  • Revision ID: james.westby@ubuntu.com-20110401000538-vkyjahgbq8v24cer
Tags: 1:7.6+4ubuntu1
https://launchpad.net/bugs/654353
[ Timo Aaltonen ]
* Merge from Debian unstable. Remaining Ubuntu changes:
  - Add apport hook
  - Demote xfonts-{75DPI,100DPI} to Suggests. Demote xfonts-scalable to
    Recommends.
  - debian/local/Failsafe*: Failsafe X hookup.
  - debian/local/Xsession: Truncate xsession-errors on startup if too big
  - debian/local/Xsession.d/20x11-common_process-args: Add support for
    session command containing args.
  - debian/local/Xsession.d/60x11-common_localhost: Authorise all processes
    running with the user's credentials to connect to the server.
  - debian/rules, debian/control:
    + Add dependencies on x11-common, and symlink /usr/share/doc directories
      of all packages to x11-common's.
  - debian/scripts/vars.*: Don't drop wacom, synaptics from *-all
  - debian/xserver-xorg.postinst.in: Also migrate users from psb → vesa.
* Removed transitional xlibmesa-gl*, libglu1-* packages, they have only
  'Suggests' or 'Recommends' rdepends left, and other packages available
  that replace them.
* x11-common: Remove obsolete failsafe configuration files from /etc/gdm.
  (LP: #654353)
* x11-common: Clean up old configuration file removals from
  {preinst,postinst,postrm}.in.
* control, rules: Don't build xsf-docs, markdown and wkhtmltopdf are in
  universe.

[ Bryce Harrington ]
* apport/source_xorg.py:
  - Include 'xinput list' output for input device issues.
  - For amd64 arch's, include version of ia32-libs package.
* scripts/vars.amd64, scripts/vars.i386:
  - Include the -qxl video driver in video-all for amd64 and i386, to
    provide remote graphical desktop functionality for KVM.
* scripts/vars.arm, scripts/vars.armeb, scripts/vars.armel:
  - Drop obscure drivers that are likely irrelevant for ARM.

Show diffs side-by-side

added added

removed removed

Lines of Context:
debian/local/dexconf.1
1
 
.\" This manpage is copyright (C) 2000, 2001, 2003, 2004 Progeny Linux
2
 
.\" Systems, Inc.
3
 
.\" Author: Branden Robinson <branden@progeny.com>
4
 
.\"
5
 
.\" This is free software; you may redistribute it and/or modify
6
 
.\" it under the terms of the GNU General Public License as
7
 
.\" published by the Free Software Foundation; either version 2,
8
 
.\" or (at your option) any later version.
9
 
.\"
10
 
.\" This is distributed in the hope that it will be useful, but
11
 
.\" WITHOUT ANY WARRANTY; without even the implied warranty of
12
 
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13
 
.\" GNU General Public License for more details.
14
 
.\"
15
 
.\" You should have received a copy of the GNU General Public License with
16
 
.\" the Debian operating system, in /usr/share/common-licenses/GPL;  if
17
 
.\" not, write to the Free Software Foundation, Inc., 59 Temple Place,
18
 
.\" Suite 330, Boston, MA 02111-1307 USA
19
 
.\"
20
 
.\" We need the URL macro from groff's www macro package, but also want
21
 
.\" things to work all right for people who don't have it.  So we define
22
 
.\" our own URL macro and let the www macro package override it if it's
23
 
.\" available.
24
 
.de URL
25
 
\\$2 \(laURL: \\$1 \(ra\\$3
26
 
..
27
 
.if \n[.g] .mso www.tmac
28
 
.TH dexconf 1 "2004\-10\-31" "Debian Project"
29
 
.SH NAME
30
 
dexconf \- generate Xorg X server configuration file from debconf data
31
 
.SH SYNOPSIS
32
 
.B dexconf
33
 
[
34
 
.I options
35
 
]
36
 
.SH DESCRIPTION
37
 
.B dexconf
38
 
retrieves values from
39
 
.BR debconf (7)'s
40
 
database and uses them to build an
41
 
.I xorg.conf
42
 
file.
43
 
.PP
44
 
The information that
45
 
.B dexconf
46
 
uses is typically entered via a debconf frontend (or possibly in part by
47
 
hardware autodetection tools).
48
 
Note that
49
 
.B dexconf
50
 
itself does
51
 
.I not
52
 
set any values in the debconf database; it only retrieves them.
53
 
If configuration parameters of the debconf database need to be changed,
54
 
.BR dpkg\-reconfigure (8)
55
 
should be used to do so.
56
 
.PP
57
 
More experienced users should feel free to use
58
 
.BR dexconf \-generated
59
 
configuration files as a starting point for their customizations, since
60
 
individual preferences vary greatly.
61
 
.SH OPTIONS
62
 
.TP
63
 
.B \-h\fR,\fB \-\-help
64
 
Display a usage message and exit.
65
 
.TP
66
 
.BI \-o\  file \fR,\fB\ \-\-output= file
67
 
By default,
68
 
.B dexconf
69
 
writes to
70
 
.IR /etc/X11/xorg.conf
71
 
This option instructs
72
 
.B dexconf
73
 
to write to
74
 
.I file
75
 
instead.
76
 
Note that
77
 
.B dexconf
78
 
unconditionally overwrites its destination file if it has sufficient access
79
 
rights to do so.
80
 
.SH ENVIRONMENT
81
 
.TP
82
 
.B COLUMNS
83
 
This variable is used to format diagnostic messages so that they fit the
84
 
width of the terminal.
85
 
If not set, a terminal width of 80 columns is assumed.
86
 
.TP
87
 
.B TMPDIR
88
 
.B dexconf
89
 
creates a subdirectory of the directory name stored in this variable, and
90
 
uses that subdirectory as a scratch area.
91
 
If not set,
92
 
.I /tmp
93
 
is used as the parent of the scratch directory.
94
 
.SH "OUTPUT FILES"
95
 
.TP
96
 
.I /etc/X11/xorg.conf
97
 
is the configuration file for the Xorg X server.
98
 
.SH DIAGNOSTICS
99
 
.B dexconf
100
 
produces diagnostic messages upon encountering various error conditions.
101
 
These messages are prefixed with the name of the command and a colon; for
102
 
example:
103
 
.RS
104
 
.BI "dexconf: " message
105
 
.RE
106
 
A list of diagnostic messages currently issued by
107
 
.B dexconf
108
 
follows.
109
 
.TP
110
 
.B This option, and XFree86 3.x output, are no longer supported.
111
 
.B dexconf
112
 
no longer supports the
113
 
.BR \-f ,
114
 
.B \-\-format
115
 
option.
116
 
See the \(lqHISTORY\(rq section below.
117
 
.TP
118
 
.BI "cannot create temporary work directory; " dirname " does not exist or is\
119
 
\& not a directory"
120
 
.B
121
 
dexconf
122
 
was unable to create a scratch directory to work in because the parent
123
 
directory
124
 
.RI ( dirname )
125
 
was not does not exist or is not a directory.
126
 
Create
127
 
.I dirname
128
 
and set its permissions properly, or set the
129
 
.B TMPDIR
130
 
environment variable to the name of an existing directory.
131
 
.TP
132
 
.BI "cannot create temporary work directory in " dirname "; directory not\
133
 
\& writable"
134
 
.B dexconf
135
 
had insufficient permissions to create a directory in
136
 
.IR dirname .
137
 
Change the permissions on
138
 
.I dirname
139
 
or set the
140
 
.B TMPDIR
141
 
environment variable to the of a writeable directory.
142
 
.TP
143
 
.BI "cannot generate configuration file; " question " not set"
144
 
An answer to the indicated
145
 
.I question
146
 
was expected in the debconf database, but none was found.
147
 
.B dexconf
148
 
cannot write a valid configuration file without this information.
149
 
This problem can be rectified by reconfiguring the X server package with
150
 
the
151
 
.BR dpkg\-reconfigure (8)
152
 
command.
153
 
.TP
154
 
.BI "creation of temporary work directory " dirname " failed"
155
 
.B dexconf
156
 
was unable to create a scratch directory
157
 
.RI ( dirname )
158
 
to work in.
159
 
This diagnostic is only issued after
160
 
.B dexconf
161
 
has checked to ensure that the parent directory of
162
 
.I dirname
163
 
is writable, and after the temporary directory to be used has been removed
164
 
(if necessary).
165
 
This diagnostic message could indicate that something on the system is
166
 
attempting to use a temporary\-file race condition to compromise the
167
 
system's integrity.
168
 
.TP
169
 
.B error while getting options
170
 
.B dexconf
171
 
received an error from
172
 
.BR getopt (1)
173
 
while attempting to interpret the command\-line arguments.
174
 
Use only the documented options.
175
 
.TP
176
 
.B received signal; aborting
177
 
.B dexconf
178
 
was sent a fatal signal; see the section on asynchronous events below.
179
 
.TP
180
 
.BI "this program does not know how to configure the " package " X server"
181
 
.B dexconf
182
 
only knows how to write configuration files for XFree86 version
183
 
.RI 4. x
184
 
X servers.
185
 
The value of the
186
 
.B shared/default\-x\-server
187
 
debconf template was set to a package name that
188
 
.B dexconf
189
 
did not recognize.
190
 
A different tool will have to be used to configure the
191
 
selected X server, or
192
 
.BR dpkg\-reconfigure (8)
193
 
will have to be used to change the default X server.
194
 
.TP
195
 
.BI "unable to write to " configfile
196
 
.B dexconf
197
 
was unable to write to
198
 
.I configfile
199
 
because it lacked permissions to do so.
200
 
Run
201
 
.B dexconf
202
 
as a user with permissions to write to
203
 
.IR configfile,
204
 
or specify an alternate file to write with the
205
 
.B \-o
206
 
or
207
 
.B \-\-output
208
 
options.
209
 
.TP
210
 
.BI "unrecognized option " "option"
211
 
An unrecognized option was specified.
212
 
Use only the documented options.
213
 
.SH "ASYNCHRONOUS EVENTS"
214
 
.B dexconf
215
 
traps the HUP, INT, QUIT, and TERM signals.
216
 
.B dexconf
217
 
removes its scratch directory and exits when it receives any of these
218
 
signals.
219
 
.SH "EXIT STATUS"
220
 
.TP
221
 
0
222
 
A configuration file was successfully written.
223
 
.TP
224
 
1
225
 
An error occurred, or
226
 
.B dexconf
227
 
was interrupted.
228
 
See the section on diagnostics above.
229
 
.SH BUGS
230
 
See
231
 
.URL "http://bugs.debian.org/xserver\-common" "the Debian Bug Tracking System" .
232
 
If you wish to report a bug in
233
 
.BR dexconf ,
234
 
please see
235
 
.I /usr/share/doc/debian/bug\-reporting.txt
236
 
or the
237
 
.BR reportbug (1)
238
 
command.
239
 
.SH AUTHOR
240
 
.B dexconf
241
 
was written by Branden Robinson with sponsorship from Progeny Linux Systems.
242
 
.SH "SEE ALSO"
243
 
.BR xorg.conf (5x),
244
 
.BR dpkg\-reconfigure (8),
245
 
.BR debconf (7)
246
 
.\" vim:set et tw=80: