sun-manpage.patch revision 1088
418N/Adiff -Nurp -x '*~' -x '*.orig' cpprules.in cpprules.in
418N/Adiff -Nurp -x '*~' -x '*.orig' cpprules.in cpprules.in
605N/A--- cpprules.in 2010-04-27 13:16:52.000000000 -0700
418N/A+++ cpprules.in 2011-02-15 15:53:08.559356397 -0800
605N/A@@ -23,7 +23,7 @@ XORGRELSTRING = @PACKAGE_STRING@
761N/A XORGMANNAME = X Version 11
418N/A XSERVERNAME = Xorg
418N/A
418N/A-MANDEFS = \
418N/A+MANDEFS = -D__SOLARIS_BUILD__ -D__distroname__="$${DISTRO_NAME}" \
418N/A -D__vendorversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" \
418N/A -D__xorgversion__="\"$(XORGRELSTRING)\" \"$(XORGMANNAME)\"" \
418N/A -D__appmansuffix__=$(APP_MAN_SUFFIX) \
418N/Adiff -Nurp -x '*~' -x '*.orig' doc/Xserver.man.pre doc/Xserver.man.pre
418N/A--- doc/Xserver.man.pre 2010-05-21 23:06:42.000000000 -0700
418N/A+++ doc/Xserver.man.pre 2011-02-15 15:53:08.559855800 -0800
418N/A@@ -1,3 +1,25 @@
418N/A+.\"
418N/A+.\" Copyright (c) 2007, 2010, Oracle and/or its affiliates. All rights reserved.
418N/A+.\"
418N/A+.\" Permission is hereby granted, free of charge, to any person obtaining a
418N/A+.\" copy of this software and associated documentation files (the "Software"),
418N/A+.\" to deal in the Software without restriction, including without limitation
418N/A+.\" the rights to use, copy, modify, merge, publish, distribute, sublicense,
418N/A+.\" and/or sell copies of the Software, and to permit persons to whom the
418N/A+.\" Software is furnished to do so, subject to the following conditions:
418N/A+.\"
418N/A+.\" The above copyright notice and this permission notice (including the next
418N/A+.\" paragraph) shall be included in all copies or substantial portions of the
418N/A+.\" Software.
418N/A+.\"
418N/A+.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
418N/A+.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
418N/A+.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
418N/A+.\" THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
493N/A+.\" LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
418N/A+.\" FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
418N/A+.\" DEALINGS IN THE SOFTWARE.
857N/A+.\"
418N/A .\" $Xorg: Xserver.man,v 1.4 2001/02/09 02:04:07 xorgcvs Exp $
418N/A .\" $XdotOrg: xserver/xorg/doc/Xserver.man.pre,v 1.4 2005/12/23 20:11:12 alanc Exp $
553N/A .\" Copyright 1984 - 1991, 1993, 1994, 1998 The Open Group
418N/A@@ -32,14 +54,31 @@ Xserver \- X Window System display serve
553N/A .SH SYNOPSIS
553N/A .B X
553N/A [option ...]
553N/A+#ifdef __SOLARIS_BUILD__
418N/A+\fB/usr/bin/Xserver\fP [\fB-c\fP \fIclass\fP] \fB:\fP\fIdisplaynumber\fP [\fIX server arguments\fP]
418N/A+#endif
418N/A+.PP
857N/A .SH DESCRIPTION
418N/A .I X
418N/A is the generic name for the X Window System display server. It is
418N/A frequently a link or a copy of the appropriate server binary for
857N/A driving the most frequently used server on a given machine.
493N/A+#ifdef __SOLARIS_BUILD__
418N/A+In this release of __distroname__, /usr/bin/X is a link to the
418N/A+Xserver program which starts the appropriate X server based on properties
418N/A+set for the service management facility, under the service identifier
851N/A+\fIsvc:/application/x11/x11-server\fP. The properties are described in the
418N/A+SMF PROPERTIES section below.
851N/A+#endif
418N/A .SH "STARTING THE SERVER"
418N/A+#ifdef __SOLARIS_BUILD__
493N/A+On __distroname__, the X server is usually started from the GNOME
418N/A+Display Manager program \fIgdm\fP(1m). This role may also be performed
857N/A+by the X Display Manager program \fIxdm\fP(1), or another display manager.
851N/A+#else
851N/A The X server is usually started from the X Display Manager program
672N/A \fIxdm\fP(1) or a similar display manager program.
418N/A+#endif
857N/A This utility is run from the system boot files and takes care of keeping
857N/A the server running, prompting for usernames and passwords, and starting up
857N/A the user sessions.
857N/A@@ -175,6 +214,35 @@ MB.
857N/A .TP 8
857N/A .B \-nocursor
857N/A disable the display of the pointer cursor.
418N/A+#ifdef __SOLARIS_BUILD__
851N/A+.TP 8
418N/A+.B \-nolisten \fItransport\fP
857N/A+disables listening for client connections on the named transport. The
857N/A+current transport names supported are as follows:
857N/A+.sp
418N/A+.nf
857N/A+tcp TCP over IPv4 or IPv6
857N/A+unix UNIX Domain Sockets (/tmp/.x11-unix)
857N/A+pipe Named pipes (/tmp/.x11-pipe/) and shared memory
857N/A+.fi
857N/A+.PP
857N/A+.in +8
857N/A+By default each of the above servers opens listeners on each of the
857N/A+above transports. The -nolisten command line argument disables listening
857N/A+on the named transports. You can disable multiple transports by listing
857N/A+this option multiple times, for example:
857N/A+.sp
857N/A+.nf
857N/A+-nolisten pipe -nolisten tcp
857N/A+.fi
857N/A+.PP
857N/A+.in -8
857N/A+.in +13
+If all available transports are disabled, then the commands issue a fatal
+error message and exit. A server not listening for any clients is of little
+value.
+.in -13
+#else
.TP 8
.B \-nolisten \fItrans-type\fP
disables a transport type. For example, TCP/IP connections can be disabled
@@ -182,6 +250,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
@@ -381,7 +450,7 @@ located in the XKB base directory or a s
relative path from the XKB base directory. The default XKB base directory is
.IR __projectroot__/lib/X11/xkb .
.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.
.TP 8
.B \-xkbdir \fIdirectory\fP
@@ -537,6 +606,117 @@ the following font path:
/usr/share/fonts/default/Type1,
/usr/share/fonts/default/ghostscript
.fi
+#ifdef __SOLARIS_BUILD__
+
+.SH SMF PROPERTIES
+.PP
+Configuration properties for the \fB/usr/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/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/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/bin/Xorg\fP
+\fB/usr/bin/i86/Xorg\fP
+\fB/usr/bin/amd64/Xorg\fP
+\fB/usr/bin/Xvfb\fP
+\fB/usr/bin/i86/Xvfb\fP
+\fB/usr/bin/amd64/Xvfb\fP
+\fB/usr/bin/Xvnc\fP
+.fi
+.TP
+.B options/config_file
+(Type string) Setting this to a filename causes this file to be used as the
+configuration file for the X server. Currently this property is only
+available when used with the Xorg server. The value of this property must
+be a relative path from one of the directories in the Xorg config file
+search path, and not an absolute path.
+.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.
+.TP
+.B options/display_0_on_console
+(Type boolean) Setting this to true starts the X server with a DISPLAY ":0.0"
+on "/dev/console" rather than the first available "/dev/vt/#", see vt(7i),
+this preserves backward compatibility with programs such as "xterm -C"
+that expect have access to "/dev/console". X servers with any other DISPLAY
+are not affected. The default is false.
+.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
+Restart the Xserver by either logging out and logging back in, or manually
+if the Xserver was started from the command line.
+.sp
+.SS "Example: Use of VESA driver"
+.PP
+The following command overrides the default Xorg driver selection to use the
+/usr/lib/X11/xorg.conf.vesa configuration file to select the "vesa" driver.
+.sp
+.nf
+svccfg -s svc:/application/x11/x11-server setprop options/config_file=xorg.conf.vesa
+.fi
+.SS "Example: Enabling the XINERAMA extension"
+.PP
+The following command enables the XINERAMA extension.
+.sp
+.nf
+svccfg -s svc:/application/x11/x11-server setprop options/server_args=+xinerama
+.fi
+#endif
.SH FILES
.TP 30
@@ -551,12 +731,23 @@ Outline font directories
.TP 30
.I /tmp/.X11-unix/X\fBn\fP
Unix domain socket for display number \fBn\fP
+#ifdef __SOLARIS_BUILD__
+.TP 30
+.I /tmp/.X11-pipe/X\fBn\fP
+Named pipe (FIFO) for display number \fBn\fP
+#endif
.TP 30
.I /usr/adm/X\fBn\fPmsgs
Error log file for display number \fBn\fP if run from \fIinit\fP(__adminmansuffix__)
.TP 30
.I __projectroot__/lib/X11/xdm/xdm-errors
Default error log file if the server is run from \fIxdm\fP(1)
+#ifdef __SOLARIS_BUILD__
+.TP 30
+.I /var/log/gdm/:\fBn\fP.log
+Default error log file for display number \fBn\fP if the server is run
+from \fIgdm\fP(1m)
+#endif
.SH "SEE ALSO"
General information: \fIX\fP(__miscmansuffix__)
.PP
@@ -573,14 +764,28 @@ Security: \fIXsecurity\fP(__miscmansuffi
\fIxdm\fP(1), \fIxhost\fP(1), \fIxfwp\fP(1),
.I "Security Extension Specification"
.PP
+#ifdef __SOLARIS_BUILD__
+Starting the server: \fIgdm\fP(1m), \fIstartx\fP(1), \fIxdm\fP(1), \fIxinit\fP(1)
+#else
Starting the server: \fIstartx\fP(1), \fIxdm\fP(1), \fIxinit\fP(1)
+#endif
.PP
Controlling the server once started: \fIxset\fP(1), \fIxsetroot\fP(1),
\fIxhost\fP(1), \fIxinput\fP(1), \fIxrandr\fP(1)
+#ifdef __SOLARIS_BUILD__
+.\" Only list the servers shipped on Solaris
+.PP
+Server-specific man pages:
+\fIXorg\fP(1), \fIXdmx\fP(1), \fIXephyr\fP(1), \fIXvfb\fP(1), \fIXvnc\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), \fIXephyr\fP(1), \fIXnest\fP(1),
\fIXvfb\fP(1), \fIXquartz\fP(1), \fIXWin\fP(1).
+#endif
.PP
Server internal documentation:
.I "Definition of the Porting Layer for the X v11 Sample Server"