XKILL(1)            X Version 11 (Release 4)             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.




  Page 1                                          (printed 8/30/91)

  XKILL(1)            X Version 11 (Release 4)             XKILL(1)



       -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













  Page 2                                          (printed 8/30/91)