sun-manpage.patch revision 110
1193N/Adiff -urp -x '*~' cpprules.in cpprules.in
1515N/A--- cpprules.in 2006-12-21 10:50:45.000000000 -0800
1193N/A+++ cpprules.in 2006-12-21 14:20:39.105037000 -0800
1193N/A@@ -25,7 +25,7 @@ XORGRELSTRING = @PACKAGE_STRING@
1193N/A XORGMANNAME = X Version 11
1193N/A XSERVERNAME = Xorg
1193N/A
1193N/A-MANDEFS = \
1193N/A+MANDEFS = -D__SUNSOFT__ \
1193N/A -D__vendorversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" \
1193N/A -D__xorgversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" \
1193N/A -D__appmansuffix__=$(APP_MAN_SUFFIX) \
1193N/Adiff -urp -x '*~' doc/Xserver.man.pre doc/Xserver.man.pre
1193N/A--- doc/Xserver.man.pre 2006-12-21 10:50:46.000000000 -0800
1193N/A+++ doc/Xserver.man.pre 2007-01-19 16:24:28.082214000 -0800
1193N/A@@ -1,3 +1,32 @@
1193N/A+.\" ident "@(#)sun-manpage.patch 1.4 07/02/21 SMI"
1193N/A+.\"
1193N/A+.\" Copyright 2007 Sun Microsystems, Inc. All rights reserved.
1193N/A+.\"
1193N/A+.\" Permission is hereby granted, free of charge, to any person obtaining a
1193N/A+.\" copy of this software and associated documentation files (the
1193N/A+.\" "Software"), to deal in the Software without restriction, including
1193N/A+.\" without limitation the rights to use, copy, modify, merge, publish,
1193N/A+.\" distribute, and/or sell copies of the Software, and to permit persons
1193N/A+.\" to whom the Software is furnished to do so, provided that the above
1193N/A+.\" copyright notice(s) and this permission notice appear in all copies of
1193N/A+.\" the Software and that both the above copyright notice(s) and this
1193N/A+.\" permission notice appear in supporting documentation.
1193N/A+.\"
1193N/A+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
1193N/A+.\" OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
1193N/A+.\" MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
1193N/A+.\" OF THIRD PARTY RIGHTS. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR
1193N/A+.\" HOLDERS INCLUDED IN THIS NOTICE BE LIABLE FOR ANY CLAIM, OR ANY SPECIAL
1193N/A+.\" INDIRECT OR CONSEQUENTIAL DAMAGES, OR ANY DAMAGES WHATSOEVER RESULTING
1193N/A+.\" FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT,
1193N/A+.\" NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING OUT OF OR IN CONNECTION
1193N/A+.\" WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
1193N/A+.\"
1193N/A+.\" Except as contained in this notice, the name of a copyright holder
1193N/A+.\" shall not be used in advertising or otherwise to promote the sale, use
1193N/A+.\" or other dealings in this Software without prior written authorization
1193N/A+.\" of the copyright holder.
1193N/A+.\"
1193N/A .\" $Xorg: Xserver.man,v 1.4 2001/02/09 02:04:07 xorgcvs Exp $
1193N/A .\" $XdotOrg: xserver/xorg/doc/Xserver.man.pre,v 1.4 2005/12/23 20:11:12 alanc Exp $
1193N/A .\" Copyright 1984 - 1991, 1993, 1994, 1998 The Open Group
1193N/A@@ -32,14 +61,32 @@ Xserver \- X Window System display serve
1193N/A .SH SYNOPSIS
1193N/A .B X
1193N/A [option ...]
1193N/A+#ifdef __SUNSOFT__
1193N/A+\fB/usr/X11/bin/Xserver\fP [\fB-c\fP \fIclass\fP] \fB:\fP\fIdisplaynumber\fP [\fIX server arguments\fP]
1193N/A+#endif
1193N/A+.PP
1193N/A .SH DESCRIPTION
1515N/A .I X
1193N/A is the generic name for the X Window System display server. It is
1193N/A frequently a link or a copy of the appropriate server binary for
1193N/A driving the most frequently used server on a given machine.
1193N/A+#ifdef __SUNSOFT__
1193N/A+In this release of Solaris, /usr/X11/bin/X is a link to the Xserver program
1193N/A+which starts the appropriate X server based on properties set for the service
1193N/A+management facility, under the service identifier
1193N/A+\fIsvc:/application/x11/x11-server\fP. The properties are described in the
1193N/A+SMF PROPERTIES section below.
1193N/A+#endif
1193N/A .SH "STARTING THE SERVER"
1193N/A+#ifdef __SUNSOFT__
1193N/A+On Solaris, the X server is usually started from the CDE Display Manager
1193N/A+program \fIdtlogin\fP(1). This role may also be performed by the X Display
1193N/A+Manager program \fIxdm\fP(1), the GNOME Display Manager program \fIgdm\fP(1),
1193N/A+or another display manager.
1193N/A+#else
1193N/A The X server is usually started from the X Display Manager program
1193N/A \fIxdm\fP(1) or a similar display manager program.
1193N/A+#endif
1193N/A This utility is run from the system boot files and takes care of keeping
1515N/A the server running, prompting for usernames and passwords, and starting up
1193N/A the user sessions.
1193N/A@@ -100,6 +147,14 @@ specifies a file which contains a collec
1193N/A to authenticate access. See also the \fIxdm\fP(1) and
1193N/A \fIXsecurity\fP(__miscmansuffix__) manual pages.
1193N/A .TP 8
1193N/A+.B bc
1193N/A+disables certain kinds of error checking, for bug compatibility with
1193N/A+previous releases (e.g., to work around bugs in R2 and R3 xterms and toolkits).
1193N/A+Deprecated.
1193N/A+#ifdef __SUNSOFT__
1193N/A+[Only available in Xsun, not in Xorg.]
1193N/A+#endif
1193N/A+.TP 8
1193N/A .B \-bs
1193N/A disables backing store support on all screens.
1193N/A .TP 8
1193N/A@@ -120,7 +175,7 @@ Not obeyed by all servers.
1193N/A .TP 8
1193N/A .B \-co \fIfilename\fP
1193N/A sets name of RGB color database. The default is
1193N/A-.IR __projectroot__/share/X11/rgb .
1193N/A+.IR __projectroot__/lib/X11/rgb .
1193N/A .ig
1193N/A .TP 8
1193N/A .B \-config \fIfilename\fP
1193N/A@@ -157,10 +212,16 @@ is platform and configuration specific.
1193N/A .BI \-extension extensionName
1193N/A disables named extension. If an unknown extension name is specified,
1193N/A a list of accepted extension names is printed.
1193N/A+#ifdef __SUNSOFT__
1193N/A+[Only available in Xorg, not in Xsun.]
1193N/A+#endif
1193N/A .TP 8
1193N/A .BI \+extension extensionName
1193N/A enables named extension. If an unknown extension name is specified,
1193N/A a list of accepted extension names is printed.
1193N/A+#ifdef __SUNSOFT__
1193N/A+[Only available in Xorg, not in Xsun.]
1193N/A+#endif
1193N/A .TP 8
1193N/A .B \-f \fIvolume\fP
1193N/A sets feep (bell) volume (allowable range: 0-100).
1193N/A@@ -187,6 +248,38 @@ causes all remaining command line argume
1193N/A sets the maximum big request to
1193N/A .I size
1193N/A MB.
1193N/A+#ifdef __SUNSOFT__
1193N/A+[Only available in Xorg, not in Xsun.]
1193N/A+#endif
1193N/A+#ifdef __SUNSOFT__
1193N/A+.TP 8
1193N/A+.B \-nolisten \fItransport\fP
1193N/A+disables listening for client connections on the named transport. The
1193N/A+current transport names supported are as follows:
1193N/A+.sp
1193N/A+.nf
1193N/A+tcp TCP over IPv4 or IPv6
1193N/A+unix UNIX Domain Sockets (/tmp/.x11-unix)
1193N/A+pipe Named pipes (/tmp/.x11-pipe/) and shared memory
1193N/A+.fi
1193N/A+.PP
1193N/A+.in +8
1193N/A+By default each of the above servers opens listeners on each of the
1193N/A+above transports. The -nolisten command line argument disables listening
1193N/A+on the named transports. You can disable multiple transports by listing
1193N/A+this option multiple times, for example:
1193N/A+.sp
1193N/A+.nf
1193N/A+-nolisten pipe -nolisten tcp
1193N/A+.fi
1193N/A+.PP
1193N/A+.in -8
1193N/A+.in +13
1193N/A+If all available transports are disabled, then the commands issue a fatal
1193N/A+error message and exit. A server not listening for any clients is of little
1193N/A+value.
1193N/A+.in -13
1193N/A+#else
1193N/A .TP 8
1193N/A .B \-nolisten \fItrans-type\fP
1193N/A disables a transport type. For example, TCP/IP connections can be disabled
@@ -194,6 +287,7 @@ with
.BR "\-nolisten tcp" .
This option may be issued multiple times to disable listening to different
transport types.
+#endif
.TP 8
.B \-noreset
prevents a server reset when the last client connection is closed. This
@@ -207,11 +301,19 @@ sets screen-saver pattern cycle time in
.B \-pn
permits the server to continue running if it fails to establish all of
its well-known sockets (connection points for clients), but
-establishes at least one. This option is set by default.
+establishes at least one.
+#ifdef __SUNSOFT__
+This option is set by default in Xorg, but is off by default in Xsun.
+#else
+This option is set by default.
+#endif
.TP 8
.B \-nopn
causes the server to exit if it fails to establish all of its well-known
sockets (connection points for clients).
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
.TP 8
.B \-r
turns off auto-repeat.
@@ -272,6 +374,10 @@ This is a no-op for most implementations
.B [+-]xinerama
enables(+) or disables(-) the XINERAMA extension. The default state is
platform and configuration specific.
+#ifdef __SUNSOFT__
+See the \fBXINERAMA\fP section of the \fIXsun\fP(1) manual page for more
+details.
+#endif
.SH SERVER DEPENDENT OPTIONS
Some X servers accept the following options:
.TP 8
@@ -315,15 +421,24 @@ use a gray map of 13 color cells for the
.TP 8
.I color
use a color cube of at most 4*4*4 colors (that is 64 color cells).
+#ifdef __SUNSOFT__
+[This option is only available in Xorg, not in Xsun.]
+#endif
.RE
.TP 8
.B \-dumbSched
disables smart scheduling on platforms that support the smart scheduler.
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
.TP
.B \-schedInterval \fIinterval\fP
sets the smart scheduler's scheduling interval to
.I interval
milliseconds.
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
.SH XDMCP OPTIONS
X servers that support XDMCP have the following options.
See the \fIX Display Manager Control Protocol\fP specification for more
@@ -361,6 +476,9 @@ specifies the local address to connect f
has multiple network interfaces). The \fIlocal-address\fP may be expressed
in any form acceptable to the host platform's \fIgethostbyname\fP(3)
implementation.
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
.TP 8
.B \-once
causes the server to terminate (rather than reset) when the XDMCP session
@@ -388,22 +506,45 @@ relative path from the XKB base director
.TP 8
.B [+-]kb
enables(+) or disables(-) the XKEYBOARD extension.
+#ifdef __SUNSOFT__
+The default XKEYBOARD state in Xsun in this release of Solaris is disabled
+unless +kb is specified. This may change in a future release. XKEYBOARD
+is enabled by default in the Xorg server.
+#endif
.TP 8
-.BR [+-]accessx " [ \fItimeout\fP [ \fItimeout_mask\fP [ \fIfeedback\fP [ \fIoptions_mask\fP ] ] ] ]"
+.BR [+-]accessx " [\fItimeout\fP[\fItimeout_mask\fP[\fIfeedback\fP[\fIoptions_mask\fP]]]]"
enables(+) or disables(-) AccessX key sequences.
+#ifndef __SUNSOFT__
.TP 8
.B \-xkbdir \fIdirectory\fP
base directory for keyboard layout files. This option is not available
for setuid X servers (i.e., when the X server's real and effective uids
are different).
+#endif
.TP 8
.B \-ardelay \fImilliseconds\fP
sets the autorepeat delay (length of time in milliseconds that a key must
be depressed before autorepeat starts).
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
.TP 8
.B \-arinterval \fImilliseconds\fP
sets the autorepeat interval (length of time in milliseconds that should
elapse between autorepeat-generated keystrokes).
+#ifdef __SUNSOFT__
+[Only available in Xorg, not in Xsun.]
+#endif
+#ifdef __SUNSOFT__
+.TP 8
+.B \-ar1 \fImilliseconds\fP
+sets the autorepeat delay (length of time in milliseconds that a key must
+be depressed before autorepeat starts).
+.TP 8
+.B \-ar2 \fImilliseconds\fP
+sets the autorepeat interval (length of time in milliseconds that should
+elapse between autorepeat-generated keystrokes).
+#endif
.TP 8
.B \-xkbmap \fIfilename\fP
loads keyboard description in \fIfilename\fP on server startup.
@@ -732,6 +873,90 @@ __default_font_path__ .
.LP
The font path can be set with the \fB\-fp\fP option or by \fIxset\fP(1)
after the server has started.
+#ifdef __SUNSOFT__
+.SH SMF PROPERTIES
+.PP
+Configuration properties for the \fB/usr/X11/bin/Xserver\fP program are
+managed by the service management facility, \fBsmf\fR(5), under the service
+identifier:
+.PP
+.nf
+svc:/application/x11/x11-server
+.fi
+Use \fBsvccfg\fR(1M) to make configuration changes and to view configuration
+information for this service\&.
+.PP
+\fB/usr/X11/bin/Xserver\fP will look for configuration options in the
+instances in this order, stopping at the first match for the given
+property:
+.TP
+1.
+\fB:display\fP\fIN\fP (where \fIN\fP is the display number of the X server,
+i.e. \fB:display0\fP for :0)
+.TP
+2.
+Any class names provided via the \fB-c\fP options to
+\fB/usr/X11/bin/Xserver\fP. Multiple \fB-c\fP options may be provided, if so,
+they are searched in the order found on the command line.
+.TP
+3.
+If any XDMCP options are provided to open a remote display connection,
+\fB:remote\fP, otherwise \fB:local\fP
+.TP
+4.
+The default properties for the service
+.PP
+Class names may be any valid FMRI instance name. Sun reserves all class names
+beginning with lowercase letters for its own use - customers wishing to create
+their own class names may use names beginning with an uppercase letter.
+
+.PP
+These properties may be set in any instance of x11-server or for the service
+itself:
+.TP
+.B options/server
+(Type astring) The absolute path to the X server binary to run, currently
+must be one of:
+.sp
+.nf
+\fB/usr/openwin/bin/Xsun\fP
+\fB/usr/openwin/bin/Xvfb\fP
+\fB/usr/X11/bin/Xorg\fP
+\fB/usr/X11/bin/i386/Xorg\fP
+\fB/usr/X11/bin/amd64/Xorg\fP
+\fB/usr/X11/bin/Xvfb\fP
+\fB/usr/X11/bin/i386/Xvfb\fP
+\fB/usr/X11/bin/amd64/Xvfb\fP
+.fi
+.TP
+.B options/tcp_listen
+(Type boolean) Setting this to false disables listening for incoming TCP/IP
+connections (see \fB-nolisten tcp\fP option above).
+.TP
+.B options/default_depth
+(Type int) Sets the depth of the default visual of the X server started.
+.TP
+.B options/server_args
+(Type astring) Sets additional arguments to pass to the X server started. Care
+must be used when using options specific to a particular X server as then it
+may cause failure to start the X server if the server to be started is later
+changed to one that does not support those options.
+.SS "Example: Allow remote access"
+.PP
+The following command allows access from remote clients.
+.sp
+.nf
+svccfg -s svc:/application/x11/x11-server setprop options/tcp_listen = true
+.fi
+.sp
+.SS "Example: Enables the XKEYBOARD extension"
+.PP
+The following command enables the XKEYBOARD extension.
+.sp
+.nf
+svccfg -s svc:/application/x11/x11-server setprop options/server_args=+kb
+.fi
+#endif
.SH FILES
.TP 30
.I /etc/X\fBn\fP.hosts
@@ -739,15 +954,26 @@ Initial access control list for display
.TP 30
.IR __projectroot__/lib/X11/fonts/misc , __projectroot__/lib/X11/fonts/75dpi , __projectroot__/lib/X11/fonts/100dpi
Bitmap font directories
+#ifdef __SUNSOFT__
.TP 30
-.IR __projectroot__/lib/X11/fonts/TTF , __projectroot__/lib/X11/fonts/Type1
+.IR __projectroot__/lib/X11/fonts/TrueType , __projectroot__/lib/X11/fonts/Speedo , __projectroot__/lib/X11/fonts/Type1
Outline font directories
+#else
.TP 30
-.I __projectroot__/share/X11/rgb.txt
+.IR __projectroot__/lib/X11/fonts/TTF , __projectroot__/lib/X11/fonts/Speedo , __projectroot__/lib/X11/fonts/Type1
+Outline font directories
+#endif
+.TP 30
+.I __projectroot__/lib/X11/rgb.txt
Color database
.TP 30
.I /tmp/.X11-unix/X\fBn\fP
Unix domain socket for display number \fBn\fP
+#ifdef __SUNSOFT__
+.TP 30
+.I /tmp/.X11-pipe/X\fBn\fP
+Named pipe (FIFO) for display number \fBn\fP
+#endif
.TP 30
.IR /tmp/rcX\fBn\fP
Kerberos 5 replay cache for display number \fBn\fP
@@ -757,6 +983,11 @@ Error log file for display number \fBn\f
.TP 30
.I __projectroot__/lib/X11/xdm/xdm-errors
Default error log file if the server is run from \fIxdm\fP(1)
+#ifdef __SUNSOFT__
+.TP 30
+.I /var/dt/Xerrors
+Default error log file if the server is run from \fIdtlogin\fP(1)
+#endif
.SH "SEE ALSO"
General information: \fIX\fP(__miscmansuffix__)
.PP
@@ -773,14 +1004,28 @@ Security: \fIXsecurity\fP(__miscmansuffi
\fIxdm\fP(1), \fIxhost\fP(1), \fIxfwp\fP(1),
.I "Security Extension Specification"
.PP
+#ifdef __SUNSOFT__
+Starting the server: \fIdtlogin\fP(1), \fIgdm\fP(1), \fIxdm\fP(1), \fIxinit\fP(1)
+#else
Starting the server: \fIxdm\fP(1), \fIxinit\fP(1)
+#endif
.PP
Controlling the server once started: \fIxset\fP(1), \fIxsetroot\fP(1),
\fIxhost\fP(1)
+#ifdef __SUNSOFT__
+.\" Only list the servers shipped on Solaris
+.PP
+Server-specific man pages:
+\fIXsun\fP(1), \fIXorg\fP(1), \fIXephyr\fP(1), \fIXnest\fP(1), \fIXvfb\fP(1), \fIXprt\fP(1)
+.PP
+Service management framework:
+\fIsmf\fP(5), \fIsvcadm\fP(1M), \fIsvccfg\fP(1M)
+#else
.PP
Server-specific man pages:
\fIXorg\fP(1), \fIXdmx\fP(1), \fIXnest\fP(1),
\fIXvfb\fP(1), \fIXDarwin\fP(1), \fIXWin\fP(1).
+#endif
.PP
Server internal documentation:
.I "Definition of the Porting Layer for the X v11 Sample Server"