Previous | Table of Contents | Next

Page 644

_name The given name is removed from the list allowed to connect to the server. The name can be a hostname or a username. Existing connections are not broken, but new connection attempts will be denied. Note that the current machine is allowed to be removed; however, further connections (including attempts to add it back) will not be permitted. Resetting the server (thereby breaking all connections) is the only way to allow local connections again.
+ Access is granted to everyone, even if they aren't on the list (in other words, access control is turned off).
_ Access is restricted to only those on the list (that is, access control is turned on).
nothing If no command-line arguments are given, a message indicating whether or not access control is currently enabled is printed, followed by the list of those allowed to connect. This is the only option that may be used from machines other than the controlling host.

NAMES

A complete name has the syntax family:name where the families are as follows:

inet Internet host
dne DECnet host
nis Secure RPC network name
krb Kerberos V5 principal
local Contains only one name, the empty string

The family is case insensitive. The format of the name varies with the family.

When Secure RPC is being used, the network-independent netname (for example, nis:unix.uid@domainname) can be specified, or a local user can be specified with just the username and a trailing at sign (@) (for example, nis:pat@).

For backward compatibility with pre-R6 xhost, names that contain an at sign are assumed to be in the nis family. Otherwise, the inet family is assumed.

DIAGNOSTICS

For each name added to the access control list, a line of the form name being added to access control list is printed. For each name removed from the access control list, a line of the form name being removed from access control list is printed.

FILES

/etc/X*.hosts

SEE ALSO

X(1), Xsecurity(1), Xserver(1), xdm(1)

ENVIRONMENT

DISPLAY To get the default host and display to use

BUGS

You can't specify a display on the command line because _display is a valid command-line argument (indicating that you want to remove the machine named display from the access list).

Page 645

The X server stores network addresses, not hostnames. This is not really a bug. If somehow you change a host's network address while the server is still running, xhost must be used to add the new address and/or remove the old address.

AUTHORS

Bob Scheifler (MIT Laboratory for Computer Science) and Jim Gettys (MIT Project Athena/DEC)

X Version 11 Release 6

xieperf

xieperf—XIE server extension test and demo program

SYNTAX

xieperf [-option ...]

DESCRIPTION

The xieperf program is based upon R5 x11perf(1) , and while not entirely comprehensive in its coverage of the XIE protocol (see the "Bugs" subsection), it is intended to be useful in the evaluation of XIE implementations in the areas of protocol adherence and performance. The xieperf program includes tests that execute each of the protocol requests and photoflo elements specified by revision 5.0 of the XIE protocol. In addition, xieperf provides a set of tests that can be used to validate the detection and transmission of XIE protocol request errors, such as FloMatch, FloValue, and so forth. Finally, xieperf provides a customizable demonstration program for XIE.

A test is made up of three components executed in sequence: an initialization function, a test function, and an end function. The initialization function is responsible for allocating and populating test resources, such as photomaps and LUTs, and for creating a stored photoflo that will be executed by the test function. The test function, in most cases, simply executes the stored photoflo for a specified number of repetitions. The end function, which is called following the test function, is used primarily to destroy any noncacheable server resources used by the test, and to free any memory that was dynamically allocated by the client. Some tests, such as -modify1, -await, -abort, and -redefine, perform additional steps within the test function inner loop, as required by the element being tested, or in an attempt to make the test more visually appealing.

Evaluating the performance of individual XIE elements is not as simple as measuring Core X drawing times. The XIE protocol requires elements to be embedded within photoflos in order to be exercised, and the minimum possible photoflo size is two. This implies that it is impossible to measure performance of a single element in isolation—the time it takes to run the flo depends on what other elements exist in the flo. Extrapolating performance of a single element (or technique) in a flo must be done carefully, on a case-by-case basis, because in general, measured element performance depends on input image size, data type, and other factors, all of which can be influenced by upstream flo elements. Note further that the number and type of elements in a flo can be influenced by the visuals available on the display, so even flo-flo comparisons on machines with different visuals must be done with caution.

Many test labels contain an abbreviated pipeline description. For instance, IP/IL/P/ED indicates ImportPhotomap, ImportLUT, Point, and ExportDrawable. Pipelines ending in ED (ExportDrawable) often include hidden elements such as BandExtract, ConvertToIndex, Dither, or Point to match the flo output to the screen visual. Pipelines ending in EP (ExportPhotomap) will result in a blank window.

xieperf is compatible with x11perfcomp(1), which is used to compare the outputs of different xieperf and x11perf runs in a nice, tabular format. In xieperf you will need to use the -labels option (see the "Options" subsection), and provide the resulting labels file to x11perfcomp(1) to obtain correct output. See the x11perfcomp(1) man pages for more details on this.

Page 646

OPTIONS

xieperf accepts the following options:

_display host:dpy Specifies which display to use.
_images <path> Normally, xieperf references image files located in the directory images, which xieperf assumes is located in your current directory. If the images directory is not in your current directory, or the file has been renamed, use this option to specify its location.
_timeout<s> Some tests require the reception of an event such as FloNotify to continue, and may cause xieperf to hang should these events not be received. This option allows the user to specify a time-out value which, if exceeded, will cause xieperf to give up waiting for an event, and continue on with the next test in sequence. Should an event time-out, a warning message will be printed to stderr. The default time-out value is 60 seconds.
_sync Runs the tests in synchronous mode.
_script <file> Using this option gives the user the ability to run a subset of the available tests and control the number of times the tests are executed on an individual basis. This is thought to be especially useful for those running xieperf for demonstration purposes. Using this option causes xieperf to read commands specified in a script file, or from stdin if <file> is -. Tests are specified by newline-terminated input lines of the form command [-reps n ] [ -repeat m ]. Characters following and including # are treated as comments. See the -mkscript option.
_repeat <n> Repeats each test n times (by default each test is run two times). This option may be used in script files also, in which case the script file -repeat overrides the command-line option.
_time <s> Specifies how long in seconds each test should be run (default 5 seconds).
_depth <depth> Use a visual with <depth> planes per pixel (default is the default visual).
_GrayScale Use a GrayScale visual (default is the default visual).
_PseudoColor Use a PseudoColor visual (default is the default visual).
_StaticGray Use a StaticGray visual (default is the default visual).
_StaticColor Use a StaticColor visual (default is the default visual).
_TrueColor Use a TrueColor visual (default is the default visual).
_DirectColor Use a DirectColor visual (default is the default visual).
_WMSafe If xieperf must be run in a window manager environment, use this flag to make xieperf aware of this. If specified, xieperf will create a window, identical to the size of the root window, and all further windows created by xieperf will be transient pop-up children of this window. If this flag is omitted, xieperf will set the override_redirect attribute of all windows to True and will also do evil things such as calling XInstallColormap. Using this option will cause the window manager to (hopefully) obey window geometry hints specified by xieperf.

Previous | Table of Contents | Next

1