winsysck - check which window system protocols are available
winsysck [ -va ] [ -display displaystring ] [ -timeout seconds ] proto- col [...]
winsysck(1) General Commands Manual winsysck(1)
NAME
winsysck - check which window system protocols are available
SYNOPSIS
winsysck [ -va ] [ -display displaystring ] [ -timeout seconds ] proto-
col [...]
DESCRIPTION
The winsysck command determines if the specified window system protocol
is available to the user. By default, the winsysck command exits as
soon as the first available protocol is found, although this behaviour
can be modified by the -a option (see below).
OPTIONS
The following options can be used to modify the behaviour of the win-
sysck command.
-a Continue to check the availability of the specified protocols
even after determining that one or more previously specified
protocols are available. This is not particularly useful with-
out the -v option (see below).
-v Print the name of the first available protocol on the standard
output. When combined with the -a option (see above), print the
name of all available protocols on the standard output, sepa-
rated by newlines.
-display displaystring
Use the display displaystring when trying to determine if the
x11 protocol is available.
-timeout seconds
The timeout option sets the number of seconds before the win-
sysck will time out.
KNOWN PROTOCOLS
The following are known values for protocol.
x11 Determines if a connection can be made using the X11 Window Sys-
tem protocol.
news Determines if a connection can be made using the Network-exten-
sible Window System protocol.
x11news
Determines if connections can be made to an X11/NeWS server. In
addition to being able to establish connections using both the
X11 Window System and Network-extensible Window System proto-
cols, this requires that these two connections actually interact
with the same window server.
sunview
Determines if connections can be made using the SunView Window
System protocol.
EXAMPLES
Determine if an X11 Window System connection can be made:
example% if winsysck x11 ; then ...
Determine if an X11 Window System connection can be made to the display
"displayhost:0.0":
example% if winsysck -display displayhost:0.0 x11 ; then ...
Print the known protocols which are available:
example% winsysck -v -a x11 news x11news sunview
Print which window system should be used, given the preference for NeWS
over SunView, and X11/NeWS over NeWS:
example% winsysck -v x11news news sunview
ATTRIBUTES
See attributes(7) for descriptions of the following attributes:
+---------------+----------------------+
|ATTRIBUTE TYPE | ATTRIBUTE VALUE |
+---------------+----------------------+
|Availability | x11/session/winsysck |
+---------------+----------------------+
|Stability | Obsolete |
+---------------+----------------------+
SEE ALSO
Xserver(1)
LIMITATIONS
There is no way to determine whether a SunView connection is actually
connected to an X11/NeWS server with SunView compatibility enabled or
to a SunView server.
winsysck assumes that no system running this version of Oracle Solaris
could be running SunView, NeWS, or X11/NeWS, so doesn't bother checking
for anything but X11.
BUGS
None known.
DIAGNOSTICS
Exit status is 0 if any protocols are available, 1 if none are avail-
able, 2 for usage errors.
2 May 2014 winsysck(1)