diff options
Diffstat (limited to 'xfs.man')
| -rw-r--r-- | xfs.man | 69 |
1 files changed, 53 insertions, 16 deletions
@@ -1,3 +1,5 @@ +.\" $XFree86: xc/programs/xfs/xfs.man,v 3.16 2001/12/14 20:01:32 dawes Exp $ +.\" .\" Copyright 1991, 1998 The Open Group .\" .\" Permission to use, copy, modify, distribute, and sell this software and its @@ -35,13 +37,18 @@ .\" suitability of this software for any purpose. It is provided "as is" .\" without express or implied warranty. .\" $Xorg: xfs.man,v 1.4 2001/02/09 02:05:42 xorgcvs Exp $ -.TH XFS 1 "Release 6.4" "X Version 11" +.TH XFS 1 __xorgversion__ .SH NAME xfs \- X font server .SH SYNOPSIS .B "xfs" [\-config \fIconfiguration_file\fP] +[\-daemon] +[\-droppriv] +[\-ls \fIlisten_socket\fP] +[\-nodaemon] [\-port \fItcp_port\fP] +[\-user \fIusername\fP] .SH DESCRIPTION .PP .I Xfs @@ -54,9 +61,11 @@ private font servers for specific sets of fonts. .SH "OPTIONS" .TP 8 .B \-config configuration_file -Specifies the configuration file the font server will use. +Specifies the configuration file the font server will use. If this +parameter is not specified, the default file, \fI/usr/X11R6/lib/X11/fs/config\fR +will be used. .TP 8 -.B \-ls listen-socket +.B \-ls listen_socket Specifies a file descriptor which is already set up to be used as the listen socket. This option is only intended to be used by the font server itself when automatically spawning another copy of itself to handle @@ -65,6 +74,31 @@ additional connections. .B \-port tcp_port Specifies the TCP port number on which the server will listen for connections. The default port number is 7100. +.TP 8 +.B \-daemon +Instructs xfs to fork and go into the background automatically at +startup If this option is not specified, xfs will run as a regular +process (unless xfs was built to daemonize by default). +.TP 8 +.B \-droppriv +If specified, xfs will attempt to run as user and group \fIxfs\fR (unless +the +.B \-user +option is used). This +has been implemented for security reasons, as xfs may have undiscovered +buffer overflows or other paths for possible exploit, both local and +remote. With this option, you may also wish to specify +"no-listen = tcp" +in the config file, which ensures that xfs will not to use a TCP port at all. +.TP 8 +.B \-nodaemon +When xfs is built to daemonize (run in the background) by default, +this prevents that and starts xfs up as a regular process. +.TP 8 +.B \-user username +This is equivalent to +.B \-droppriv +except that xfs will run as user \fIusername\fR. .SH "SIGNALS" .TP 8 .I SIGTERM @@ -116,6 +150,9 @@ Multiple resolutions are separated by commas. .IP "error-file (string)" Filename of the error file. All warnings and errors will be logged here. +.IP "no-listen (trans-type)" +Disable a transport type. For example, TCP/IP connections can +be disabled with no-listen tcp .IP "port (cardinal)" TCP port on which the server will listen for connections. .IP "use-syslog (boolean)" @@ -132,31 +169,31 @@ enabled for all fonts, and "16", meaning it is enabled only for .\" list means the server will talk to any client. .SH "EXAMPLE" .nf -# -# sample font server configuration file -# +XCOMM +XCOMM sample font server configuration file +XCOMM -# allow a max of 10 clients to connect to this font server +XCOMM allow a max of 10 clients to connect to this font server client-limit = 10 -# when a font server reaches its limit, start up a new one +XCOMM when a font server reaches its limit, start up a new one clone-self = on -# alternate font servers for clients to use +XCOMM alternate font servers for clients to use alternate-servers = hansen:7101,hansen:7102 -# where to look for fonts -# the first is a set of Speedo outlines, the second is a set of -# misc bitmaps and the last is a set of 100dpi bitmaps -# +XCOMM where to look for fonts +XCOMM the first is a set of Speedo outlines, the second is a set of +XCOMM misc bitmaps and the last is a set of 100dpi bitmaps +XCOMM catalogue = /usr/X11R6/lib/X11/fonts/speedo, /usr/X11R6/lib/X11/fonts/misc, /usr/X11R6/lib/X11/fonts/100dpi/ -# in 12 points, decipoints +XCOMM in 12 points, decipoints default-point-size = 120 -# 100 x 100 and 75 x 75 +XCOMM 100 x 100 and 75 x 75 default-resolutions = 100,100,75,75 use-syslog = off .fi @@ -194,7 +231,7 @@ with '+' as a separator. .PP Examples: \fIDECnet/SRVNOD::FONT$DEFAULT\fP, \fIdecnet/44.70::font$special/symbols\fP. .SH "SEE ALSO" -X(1), \fIThe X Font Service Protocol\fP, +X(__miscmansuffix__), \fIThe X Font Service Protocol\fP, .br \fIFont server implementation overview\fP .SH BUGS |