File: update-xaw-wrappers.8

package info (click to toggle)
xaw-wrappers 0.23
  • links: PTS
  • area: main
  • in suites: slink
  • size: 72 kB
  • ctags: 14
  • sloc: perl: 237; makefile: 35; sh: 31
file content (93 lines) | stat: -rw-r--r-- 3,003 bytes parent folder | download | duplicates (2)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
.TH UPDATE-XAW-WRAPPERS 8
.SH NAME
update-xaw-wrappers \- allow use of programs with Xaw replacements
.SH SYNOPSIS
.B update-xaw-wrappers
.I "[options]"
.SH "DESCRIPTION"
Debian has several packages like xaw3d and nextaw that provide a replacement
to the standard Xaw library.  There is a problem that due to
incompatibilities and bugs, some programs do not work well with all Xaw
replacements.
.P
.B update-xaw-wrappers
installs wrapper scripts around such programs in order to alter the
ordering of library linking set-up by the Xaw replacement packages or
the local system administrator. The wrapper figures out what Xaw
replacements the program cannot use, and sets the LD_LIBRARY_PATH
variable to force the program not to use those libraries, and then
runs the program.
.P
To place a wrapper around a program,
.B update-xaw-wrappers
uses 
.BR dpkg-divert
to move the real program to program.real. It installs a symlink in place
of the program that points to the generic wrapper script, which when run
will execute program.real.
.P
.B update-xaw-wrappers
must be run as root.
.SH OPTIONS
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-verbose
Be verbose about what changes are made.
.TP
.B \-f, \-\-force
Force removal and reset up all wrappers.
.TP
.B \-o, \-\-off
Only remove existing wrappers, do not add new.
.SH CAVEATS
The setup of the Xaw replacement system is the responsibility of the
individual Xaw replacment packages and is outside of the scope of
this package.  Please refer to the documentation for the Xaw
replacement package.
.SH FILES
.IP /etc/ld.so.conf
Manipulated by Xaw replacement packages in order to change link order.
This is generally how Xaw replacment packages override the standard
libXaw.
.IP /var/lib/xaw-wrappers/update-wrappers-history
Lists programs that currently have a wrapper installed around them.
.IP /usr/lib/xaw-wrappers/conf/*
Config files for the program.
These files are installed by Debian packages that need to tell xaw-wrappers 
about incompatibilities.
.IP /etc/X11/xaw-wrappers.conf
The global config file, for customization by the sysadmin.
.P
The format of these files is:
.PP
\fIfilename,dirname\fP
.RS
.IP filename
The filename of a program that must be wrapped because it does not work with
some Xaw replacement library. Note that it is important that you use the
exact same filename dpkg uses when it lists this file. For example, 
do not use /usr/bin/X11/filename, use /usr/X11R6/bin/filename instead.
.IP dirname
The directory the bad Xaw replacement library is in, the same as it appears
in
.BR ld.so.conf
.RS
.P
As a special case, If dirname is "NONE", then any dirnames previously 
specified for the filename will be ignored. This allows you to disable a 
program from being wrapped.
.RE
.RE
.P
Any line starting with a # character is ignored.
.SH ENVIRONMENT
.IP LD_LIBRARY_PATH
Tells 
.BR ld.so (8)
the search order for libraries. Modified by the wrapper.
.SH COPYRIGHT
GPL
.SH AUTHOR
Joey Hess <joeyh@master.debian.org>