← Back to branch summary

~ubuntu-branches/ubuntu/gutsy/vnc4/gutsy

« back to all changes in this revision

Viewing changes to unix/xc/programs/xwd/xwd.man

  • Committer: Bazaar Package Importer
  • Author(s): Ola Lundqvist
  • Date: 2006-05-15 20:35:17 UTC
  • mfrom: (1.1.2 upstream)
  • Revision ID: james.westby@ubuntu.com-20060515203517-l4lre1ku942mn26k
Tags: 4.1.1+X4.3.0-10
* Correction of critical security issue. Thanks to Martin Kogler
  <e9925248@student.tuwien.ac.at> that informed me about the issue,
  and provided the patch.
  This flaw was originally found by Steve Wiseman of intelliadmin.com.
* Applied patch from Javier Kohen <jkohen@users.sourceforge.net> that
  inform the user that only 8 first characters of the password will
  actually be used when typing more than 8 characters, closes:
  #355619.

Show diffs side-by-side

added added

removed removed

Lines of Context:
unix/xc/programs/xwd/xwd.man
 
1
.\" $Xorg: xwd.man,v 1.4 2001/02/09 02:06:03 xorgcvs Exp $
 
2
.\" Copyright 1988, 1994, 1998  The Open Group
 
3
.\" 
 
4
.\" Permission to use, copy, modify, distribute, and sell this software and its
 
5
.\" documentation for any purpose is hereby granted without fee, provided that
 
6
.\" the above copyright notice appear in all copies and that both that
 
7
.\" copyright notice and this permission notice appear in supporting
 
8
.\" documentation.
 
9
.\" 
 
10
.\" The above copyright notice and this permission notice shall be included
 
11
.\" in all copies or substantial portions of the Software.
 
12
.\" 
 
13
.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 
14
.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 
15
.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
 
16
.\" IN NO EVENT SHALL THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR
 
17
.\" OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
 
18
.\" ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
 
19
.\" OTHER DEALINGS IN THE SOFTWARE.
 
20
.\" 
 
21
.\" Except as contained in this notice, the name of The Open Group shall
 
22
.\" not be used in advertising or otherwise to promote the sale, use or
 
23
.\" other dealings in this Software without prior written authorization
 
24
.\" from The Open Group.
 
25
.\"
 
26
.\" $XFree86: xc/programs/xwd/xwd.man,v 1.9 2002/04/22 20:53:10 herrb Exp $
 
27
.\"
 
28
.TH XWD 1 __xorgversion__
 
29
.SH NAME
 
30
xwd - dump an image of an X window
 
31
.SH SYNOPSIS
 
32
.B "xwd"
 
33
[-debug] [-help] [-nobdrs] [-out \fIfile\fP] [-xy] [-frame] [-add \fIvalue\fP]
 
34
[-root | -id \fIid\fP | -name \fIname\fP ] [-icmap] [-screen]
 
35
[-display \fIdisplay\fP]
 
36
.SH DESCRIPTION
 
37
.PP
 
38
.I Xwd
 
39
is an X Window System window dumping utility.
 
40
.I Xwd
 
41
allows X users to store window images in a specially formatted dump
 
42
file.  This file can then be read by various other X utilities for
 
43
redisplay, printing, editing, formatting, archiving, image processing, etc.
 
44
The target window is selected by clicking the pointer in the desired window.
 
45
The keyboard bell is rung once at the beginning of the dump and twice when
 
46
the dump is completed.
 
47
.SH OPTIONS
 
48
.PP
 
49
.TP 8
 
50
.B "-display \fIdisplay\fP"
 
51
This argument allows you to specify the server to connect to; see \fIX(__miscmansuffix__)\fP.
 
52
.PP
 
53
.TP 8
 
54
.B "-help"
 
55
Print out the `Usage:' command syntax summary.
 
56
.PP
 
57
.TP 8
 
58
.B "-nobdrs"
 
59
This argument specifies that the window dump should not include the
 
60
pixels that compose the X window border.  This is useful in situations
 
61
where you may wish to include the window contents in a document 
 
62
as an illustration.
 
63
.PP
 
64
.TP 8
 
65
.B "-out \fIfile\fP"
 
66
This argument allows the user to explicitly specify the output
 
67
file on the command line.  The default is to output to standard out.
 
68
.PP
 
69
.TP 8
 
70
.B "-xy"
 
71
This option applies to color displays only. It selects `XY' format dumping
 
72
instead of the default `Z' format.
 
73
.PP
 
74
.TP 8
 
75
.B "-add \fIvalue\fP"
 
76
This option specifies an signed value to be added to every pixel.
 
77
.PP
 
78
.TP 8
 
79
.B "-frame"
 
80
This option indicates that the window manager frame should be included when
 
81
manually selecting a window.
 
82
.PP
 
83
.TP 8
 
84
.B "-root"
 
85
This option indicates that the root window should be selected for the
 
86
window dump, without requiring the user to select a window with the pointer.
 
87
.PP
 
88
.TP 8
 
89
.B "-id \fIid\fP"
 
90
This option indicates that the window with the specified resource id
 
91
should be selected for the window dump, without requiring the user to
 
92
select a window with the pointer.
 
93
.PP
 
94
.TP 8
 
95
.B "-name \fIname\fP"
 
96
This option indicates that the window with the specified WM_NAME property
 
97
should be selected for the window dump, without requiring the user to
 
98
select a window with the pointer.
 
99
.PP
 
100
.TP 8
 
101
.B "-icmap"
 
102
Normally the colormap of the chosen window is used to obtain RGB values.
 
103
This option forces the first installed colormap of the screen to be used
 
104
instead.
 
105
.PP
 
106
.TP 8
 
107
.B "-screen"
 
108
This option indicates that the GetImage request used to obtain the image
 
109
should be done on the root window, rather than directly on the specified
 
110
window.  In this way, you can obtain pieces of other windows that overlap
 
111
the specified window, and more importantly, you can capture menus or other
 
112
popups that are independent windows but appear over the specified window.
 
113
.PP
 
114
.TP 8
 
115
.B "-silent"
 
116
Operate silently, i.e. don't ring any bells before and after dumping
 
117
the window.
 
118
.SH ENVIRONMENT
 
119
.PP
 
120
.TP 8
 
121
.B DISPLAY
 
122
To get default host and display number.
 
123
.SH FILES
 
124
.PP
 
125
.TP 8
 
126
.B XWDFile.h
 
127
X Window Dump File format definition file.
 
128
.SH SEE ALSO
 
129
xwud(1), X(__miscmansuffix__)
 
130
.SH AUTHORS
 
131
Tony Della Fera, Digital Equipment Corp., MIT Project Athena
 
132
.br
 
133
William F. Wyatt, Smithsonian Astrophysical Observatory