← Back to branch summary

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

« back to all changes in this revision

Viewing changes to unix/xc/programs/xkill/xkill.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/xkill/xkill.man
 
1
.\" $Xorg: xkill.man,v 1.4 2001/02/09 02:05:54 xorgcvs Exp $
 
2
.\" Copyright 1988, 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/xkill/xkill.man,v 1.8 2001/12/14 20:02:06 dawes Exp $
 
27
.\"
 
28
.TH XKILL 1 __xorgversion__
 
29
.SH NAME
 
30
xkill - kill a client by its X resource
 
31
.SH SYNOPSIS
 
32
.B "xkill"
 
33
[\-display \fIdisplayname\fP] [\-id \fIresource\fP] [\-button number] [\-frame] [\-all] 
 
34
.SH DESCRIPTION
 
35
.PP
 
36
.I Xkill
 
37
is a utility for forcing the X server to close connections to clients.  This
 
38
program is very dangerous, but is useful for aborting programs that have 
 
39
displayed undesired windows on a user's screen.  If no resource identifier
 
40
is given with \fI-id\fP, \fIxkill\fP will display a special cursor
 
41
as a prompt for the user to select a window to be killed.  If a pointer button
 
42
is pressed over a non-root window, the server will close its connection to
 
43
the client that created the window.
 
44
.SH OPTIONS
 
45
.TP 8
 
46
.B \-display \fIdisplayname\fP
 
47
This option specifies the name of the X server to contact.
 
48
.TP 8
 
49
.B \-id \fIresource\fP
 
50
This option specifies the X identifier for the resource whose creator is
 
51
to be aborted.  If no resource is specified, \fIxkill\fP will display a 
 
52
special cursor with which you should select a window to be kill.
 
53
.TP 8
 
54
.B \-button \fInumber\fP
 
55
This option specifies the number of pointer button
 
56
that should be used in selecting a window to kill.  
 
57
If the word "any" is specified, any button on the pointer may be used.  By
 
58
default, the first button in the pointer map (which is usually the leftmost
 
59
button) is used.
 
60
.TP 8
 
61
.B \-all
 
62
This option indicates that all clients with top-level windows on the screen
 
63
should be killed.  \fIXkill\fP will ask you to select the root window with 
 
64
each of the currently defined buttons to give you several chances to abort.
 
65
Use of this option is highly discouraged.
 
66
.TP 8
 
67
.B \-frame
 
68
This option indicates that xkill should ignore the standard conventions for
 
69
finding top-level client windows (which are typically nested inside a window
 
70
manager window), and simply believe that you want to kill direct children of
 
71
the root.
 
72
.SH XDEFAULTS
 
73
.TP 8
 
74
.B Button
 
75
Specifies a specific pointer button number or the word "any" to use when 
 
76
selecting windows.
 
77
.SH "SEE ALSO"
 
78
X(__miscmansuffix__), xwininfo(1), XKillClient and XGetPointerMapping in the Xlib Programmers 
 
79
Manual, KillClient in the X Protocol Specification
 
80
.SH AUTHOR
 
81
Jim Fulton, MIT X Consortium
 
82
.br
 
83
Dana Chee, Bellcore