XKILL(1)                        X11 R4.11MU05                       XKILL(1)


NAME
       xkill - kill a client by its X resource

SYNOPSIS
       xkill [-display displayname] [-id resource] [-button number]
             [-frame] [-all]

DESCRIPTION
       Xkill is a utility for forcing the X server to close connections to
       clients.  This program is very dangerous, but is useful for aborting
       programs that have displayed undesired windows on a user's screen.
       If no resource identifier is given with -id, xkill will display a
       special cursor as a prompt for the user to select a window to be
       killed.  If a pointer button is pressed over a non-root window, the
       server will close its connection to the client that created the
       window.

OPTIONS
       -display displayname
               This option specifies the name of the X server to contact.

       -id resource
               This option specifies the X identifier for the resource whose
               creator is to be aborted.  If no resource is specified, xkill
               will display a special cursor with which you should select a
               window to be kill.

       -button number
               This option specifies the number of pointer button that
               should be used in selecting a window to kill.  If the word
               "any" is specified, any button on the pointer may be used.
               By default, the first button in the pointer map (which is
               usually the leftmost button) is used.

       -all    This option indicates that all clients with top-level windows
               on the screen should be killed.  Xkill will ask you to select
               the root window with each of the currently defined buttons to
               give you several chances to abort.  Use of this option is
               highly discouraged.

       -frame  This option indicates that xkill should ignore the standard
               conventions for finding top-level client windows (which are
               typically nested inside a window manager window), and simply
               believe that you want to kill direct children of the root.

XDEFAULTS
       Button  Specifies a specific pointer button number or the word "any"
               to use when selecting windows.

SEE ALSO
       X(1), xwininfo(1), XKillClient and XGetPointerMapping in the Xlib
       Programmers Manual, KillClient in the X Protocol Specification

COPYRIGHT
       Copyright 1988, Massachusetts Institute of Technology.
       See X(1) for a full statement of rights and permissions.

AUTHOR
       Jim Fulton, MIT X Consortium
       Dana Chee, Bellcore


Licensed material--property of copyright holder(s)