From fdf2aa9d72d98f765c4e3cb1ec47778e4bcb5c0b Mon Sep 17 00:00:00 2001 From: Matthieu Herrb Date: Sun, 31 Oct 2010 19:35:20 +0000 Subject: Update to xfs 1.1.1 --- app/xfs/man/Makefile.am | 41 +++++ app/xfs/man/Makefile.in | 407 ++++++++++++++++++++++++++++++++++++++++++++++++ app/xfs/man/xfs.man | 389 +++++++++++++++++++++++++++++++++++++++++++++ 3 files changed, 837 insertions(+) create mode 100644 app/xfs/man/Makefile.am create mode 100644 app/xfs/man/Makefile.in create mode 100644 app/xfs/man/xfs.man (limited to 'app/xfs/man') diff --git a/app/xfs/man/Makefile.am b/app/xfs/man/Makefile.am new file mode 100644 index 000000000..290f3f6f7 --- /dev/null +++ b/app/xfs/man/Makefile.am @@ -0,0 +1,41 @@ +# +# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved. +# +# Permission is hereby granted, free of charge, to any person obtaining a +# copy of this software and associated documentation files (the "Software"), +# to deal in the Software without restriction, including without limitation +# the rights to use, copy, modify, merge, publish, distribute, sublicense, +# and/or sell copies of the Software, and to permit persons to whom the +# Software is furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice (including the next +# paragraph) shall be included in all copies or substantial portions of the +# Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +# DEALINGS IN THE SOFTWARE. +# + +appmandir = $(APP_MAN_DIR) + +appman_PRE = xfs.man + +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) + +EXTRA_DIST = $(appman_PRE) + +CLEANFILES = $(appman_DATA) + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +MAN_SUBSTS += -e 's|__configfiledesc__|$(CONFIG_FILE_DESC)|g' +MAN_SUBSTS += -e 's|__configfilepath__|$(CONFIG_FILE_PATH)|g' + +SUFFIXES = .$(APP_MAN_SUFFIX) .man + +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ diff --git a/app/xfs/man/Makefile.in b/app/xfs/man/Makefile.in new file mode 100644 index 000000000..145f68caf --- /dev/null +++ b/app/xfs/man/Makefile.in @@ -0,0 +1,407 @@ +# Makefile.in generated by automake 1.9.6 from Makefile.am. +# @configure_input@ + +# Copyright (C) 1994, 1995, 1996, 1997, 1998, 1999, 2000, 2001, 2002, +# 2003, 2004, 2005 Free Software Foundation, Inc. +# This Makefile.in is free software; the Free Software Foundation +# gives unlimited permission to copy and/or distribute it, +# with or without modifications, as long as this notice is preserved. + +# This program is distributed in the hope that it will be useful, +# but WITHOUT ANY WARRANTY, to the extent permitted by law; without +# even the implied warranty of MERCHANTABILITY or FITNESS FOR A +# PARTICULAR PURPOSE. + +@SET_MAKE@ + +# +# Copyright (c) 2010, Oracle and/or its affiliates. All rights reserved. +# +# Permission is hereby granted, free of charge, to any person obtaining a +# copy of this software and associated documentation files (the "Software"), +# to deal in the Software without restriction, including without limitation +# the rights to use, copy, modify, merge, publish, distribute, sublicense, +# and/or sell copies of the Software, and to permit persons to whom the +# Software is furnished to do so, subject to the following conditions: +# +# The above copyright notice and this permission notice (including the next +# paragraph) shall be included in all copies or substantial portions of the +# Software. +# +# THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +# IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +# FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +# THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER +# LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING +# FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER +# DEALINGS IN THE SOFTWARE. +# + +srcdir = @srcdir@ +top_srcdir = @top_srcdir@ +VPATH = @srcdir@ +pkgdatadir = $(datadir)/@PACKAGE@ +pkglibdir = $(libdir)/@PACKAGE@ +pkgincludedir = $(includedir)/@PACKAGE@ +top_builddir = .. +am__cd = CDPATH="$${ZSH_VERSION+.}$(PATH_SEPARATOR)" && cd +INSTALL = @INSTALL@ +install_sh_DATA = $(install_sh) -c -m 644 +install_sh_PROGRAM = $(install_sh) -c +install_sh_SCRIPT = $(install_sh) -c +INSTALL_HEADER = $(INSTALL_DATA) +transform = $(program_transform_name) +NORMAL_INSTALL = : +PRE_INSTALL = : +POST_INSTALL = : +NORMAL_UNINSTALL = : +PRE_UNINSTALL = : +POST_UNINSTALL = : +build_triplet = @build@ +host_triplet = @host@ +subdir = man +DIST_COMMON = $(srcdir)/Makefile.am $(srcdir)/Makefile.in +ACLOCAL_M4 = $(top_srcdir)/aclocal.m4 +am__aclocal_m4_deps = $(top_srcdir)/m4/ax_define_dir.m4 \ + $(top_srcdir)/configure.ac +am__configure_deps = $(am__aclocal_m4_deps) $(CONFIGURE_DEPENDENCIES) \ + $(ACLOCAL_M4) +mkinstalldirs = $(SHELL) $(install_sh) -d +CONFIG_HEADER = $(top_builddir)/xfs-config.h +CONFIG_CLEAN_FILES = +SOURCES = +DIST_SOURCES = +am__vpath_adj_setup = srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; +am__vpath_adj = case $$p in \ + $(srcdir)/*) f=`echo "$$p" | sed "s|^$$srcdirstrip/||"`;; \ + *) f=$$p;; \ + esac; +am__strip_dir = `echo $$p | sed -e 's|^.*/||'`; +am__installdirs = "$(DESTDIR)$(appmandir)" +appmanDATA_INSTALL = $(INSTALL_DATA) +DATA = $(appman_DATA) +DISTFILES = $(DIST_COMMON) $(DIST_SOURCES) $(TEXINFOS) $(EXTRA_DIST) +ACLOCAL = @ACLOCAL@ +ADMIN_MAN_DIR = @ADMIN_MAN_DIR@ +ADMIN_MAN_SUFFIX = @ADMIN_MAN_SUFFIX@ +AMDEP_FALSE = @AMDEP_FALSE@ +AMDEP_TRUE = @AMDEP_TRUE@ +AMTAR = @AMTAR@ +AM_DEFAULT_VERBOSITY = @AM_DEFAULT_VERBOSITY@ +APP_MAN_DIR = @APP_MAN_DIR@ +APP_MAN_SUFFIX = @APP_MAN_SUFFIX@ +AUTOCONF = @AUTOCONF@ +AUTOHEADER = @AUTOHEADER@ +AUTOMAKE = @AUTOMAKE@ +AWK = @AWK@ +CC = @CC@ +CCDEPMODE = @CCDEPMODE@ +CFLAGS = @CFLAGS@ +CHANGELOG_CMD = @CHANGELOG_CMD@ +CONFIG_FILE_DESC = @CONFIG_FILE_DESC@ +CONFIG_FILE_PATH = @CONFIG_FILE_PATH@ +CPP = @CPP@ +CPPFLAGS = @CPPFLAGS@ +CWARNFLAGS = @CWARNFLAGS@ +CYGPATH_W = @CYGPATH_W@ +DEFAULT_CONFIG_FILE = @DEFAULT_CONFIG_FILE@ +DEFS = @DEFS@ +DEPDIR = @DEPDIR@ +DRIVER_MAN_DIR = @DRIVER_MAN_DIR@ +DRIVER_MAN_SUFFIX = @DRIVER_MAN_SUFFIX@ +ECHO_C = @ECHO_C@ +ECHO_N = @ECHO_N@ +ECHO_T = @ECHO_T@ +EGREP = @EGREP@ +ENABLE_DEVEL_DOCS_FALSE = @ENABLE_DEVEL_DOCS_FALSE@ +ENABLE_DEVEL_DOCS_TRUE = @ENABLE_DEVEL_DOCS_TRUE@ +EXEEXT = @EXEEXT@ +FILE_MAN_DIR = @FILE_MAN_DIR@ +FILE_MAN_SUFFIX = @FILE_MAN_SUFFIX@ +FONTPATH = @FONTPATH@ +FONTROOTDIR = @FONTROOTDIR@ +FOP = @FOP@ +GREP = @GREP@ +HAVE_FOP_FALSE = @HAVE_FOP_FALSE@ +HAVE_FOP_TRUE = @HAVE_FOP_TRUE@ +HAVE_STYLESHEETS_FALSE = @HAVE_STYLESHEETS_FALSE@ +HAVE_STYLESHEETS_TRUE = @HAVE_STYLESHEETS_TRUE@ +HAVE_XMLTO_FALSE = @HAVE_XMLTO_FALSE@ +HAVE_XMLTO_TEXT_FALSE = @HAVE_XMLTO_TEXT_FALSE@ +HAVE_XMLTO_TEXT_TRUE = @HAVE_XMLTO_TEXT_TRUE@ +HAVE_XMLTO_TRUE = @HAVE_XMLTO_TRUE@ +INSTALL_CMD = @INSTALL_CMD@ +INSTALL_DATA = @INSTALL_DATA@ +INSTALL_PROGRAM = @INSTALL_PROGRAM@ +INSTALL_SCRIPT = @INSTALL_SCRIPT@ +INSTALL_STRIP_PROGRAM = @INSTALL_STRIP_PROGRAM@ +LDFLAGS = @LDFLAGS@ +LIBOBJS = @LIBOBJS@ +LIBS = @LIBS@ +LIB_MAN_DIR = @LIB_MAN_DIR@ +LIB_MAN_SUFFIX = @LIB_MAN_SUFFIX@ +LINT = @LINT@ +LINT_FALSE = @LINT_FALSE@ +LINT_FLAGS = @LINT_FLAGS@ +LINT_TRUE = @LINT_TRUE@ +LTLIBOBJS = @LTLIBOBJS@ +MAINT = @MAINT@ +MAINTAINER_MODE_FALSE = @MAINTAINER_MODE_FALSE@ +MAINTAINER_MODE_TRUE = @MAINTAINER_MODE_TRUE@ +MAKEINFO = @MAKEINFO@ + +# String replacements in MAN_SUBSTS now come from xorg-macros.m4 via configure +MAN_SUBSTS = @MAN_SUBSTS@ -e \ + 's|__configfiledesc__|$(CONFIG_FILE_DESC)|g' -e \ + 's|__configfilepath__|$(CONFIG_FILE_PATH)|g' +MISC_MAN_DIR = @MISC_MAN_DIR@ +MISC_MAN_SUFFIX = @MISC_MAN_SUFFIX@ +OBJEXT = @OBJEXT@ +PACKAGE = @PACKAGE@ +PACKAGE_BUGREPORT = @PACKAGE_BUGREPORT@ +PACKAGE_NAME = @PACKAGE_NAME@ +PACKAGE_STRING = @PACKAGE_STRING@ +PACKAGE_TARNAME = @PACKAGE_TARNAME@ +PACKAGE_VERSION = @PACKAGE_VERSION@ +PATH_SEPARATOR = @PATH_SEPARATOR@ +PKG_CONFIG = @PKG_CONFIG@ +SED = @SED@ +SET_MAKE = @SET_MAKE@ +SHELL = @SHELL@ +STRIP = @STRIP@ +STYLESHEET_SRCDIR = @STYLESHEET_SRCDIR@ +VERSION = @VERSION@ +XFS_CFLAGS = @XFS_CFLAGS@ +XFS_LIBS = @XFS_LIBS@ +XMLTO = @XMLTO@ +XORG_MAN_PAGE = @XORG_MAN_PAGE@ +XORG_SGML_PATH = @XORG_SGML_PATH@ +XSL_STYLESHEET = @XSL_STYLESHEET@ +ac_ct_CC = @ac_ct_CC@ +am__fastdepCC_FALSE = @am__fastdepCC_FALSE@ +am__fastdepCC_TRUE = @am__fastdepCC_TRUE@ +am__include = @am__include@ +am__leading_dot = @am__leading_dot@ +am__quote = @am__quote@ +am__tar = @am__tar@ +am__untar = @am__untar@ +bindir = @bindir@ +build = @build@ +build_alias = @build_alias@ +build_cpu = @build_cpu@ +build_os = @build_os@ +build_vendor = @build_vendor@ +datadir = @datadir@ +datarootdir = @datarootdir@ +docdir = @docdir@ +dvidir = @dvidir@ +exec_prefix = @exec_prefix@ +host = @host@ +host_alias = @host_alias@ +host_cpu = @host_cpu@ +host_os = @host_os@ +host_vendor = @host_vendor@ +htmldir = @htmldir@ +includedir = @includedir@ +infodir = @infodir@ +install_sh = @install_sh@ +libdir = @libdir@ +libexecdir = @libexecdir@ +localedir = @localedir@ +localstatedir = @localstatedir@ +mandir = @mandir@ +mkdir_p = @mkdir_p@ +oldincludedir = @oldincludedir@ +pdfdir = @pdfdir@ +prefix = @prefix@ +program_transform_name = @program_transform_name@ +psdir = @psdir@ +sbindir = @sbindir@ +sharedstatedir = @sharedstatedir@ +sysconfdir = @sysconfdir@ +target_alias = @target_alias@ +appmandir = $(APP_MAN_DIR) +appman_PRE = xfs.man +appman_DATA = $(appman_PRE:man=$(APP_MAN_SUFFIX)) +EXTRA_DIST = $(appman_PRE) +CLEANFILES = $(appman_DATA) +SUFFIXES = .$(APP_MAN_SUFFIX) .man +all: all-am + +.SUFFIXES: +.SUFFIXES: .$(APP_MAN_SUFFIX) .man +$(srcdir)/Makefile.in: @MAINTAINER_MODE_TRUE@ $(srcdir)/Makefile.am $(am__configure_deps) + @for dep in $?; do \ + case '$(am__configure_deps)' in \ + *$$dep*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh \ + && exit 0; \ + exit 1;; \ + esac; \ + done; \ + echo ' cd $(top_srcdir) && $(AUTOMAKE) --foreign man/Makefile'; \ + cd $(top_srcdir) && \ + $(AUTOMAKE) --foreign man/Makefile +.PRECIOUS: Makefile +Makefile: $(srcdir)/Makefile.in $(top_builddir)/config.status + @case '$?' in \ + *config.status*) \ + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh;; \ + *) \ + echo ' cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe)'; \ + cd $(top_builddir) && $(SHELL) ./config.status $(subdir)/$@ $(am__depfiles_maybe);; \ + esac; + +$(top_builddir)/config.status: $(top_srcdir)/configure $(CONFIG_STATUS_DEPENDENCIES) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh + +$(top_srcdir)/configure: @MAINTAINER_MODE_TRUE@ $(am__configure_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +$(ACLOCAL_M4): @MAINTAINER_MODE_TRUE@ $(am__aclocal_m4_deps) + cd $(top_builddir) && $(MAKE) $(AM_MAKEFLAGS) am--refresh +uninstall-info-am: +install-appmanDATA: $(appman_DATA) + @$(NORMAL_INSTALL) + test -z "$(appmandir)" || $(mkdir_p) "$(DESTDIR)$(appmandir)" + @list='$(appman_DATA)'; for p in $$list; do \ + if test -f "$$p"; then d=; else d="$(srcdir)/"; fi; \ + f=$(am__strip_dir) \ + echo " $(appmanDATA_INSTALL) '$$d$$p' '$(DESTDIR)$(appmandir)/$$f'"; \ + $(appmanDATA_INSTALL) "$$d$$p" "$(DESTDIR)$(appmandir)/$$f"; \ + done + +uninstall-appmanDATA: + @$(NORMAL_UNINSTALL) + @list='$(appman_DATA)'; for p in $$list; do \ + f=$(am__strip_dir) \ + echo " rm -f '$(DESTDIR)$(appmandir)/$$f'"; \ + rm -f "$(DESTDIR)$(appmandir)/$$f"; \ + done +tags: TAGS +TAGS: + +ctags: CTAGS +CTAGS: + + +distdir: $(DISTFILES) + @srcdirstrip=`echo "$(srcdir)" | sed 's|.|.|g'`; \ + topsrcdirstrip=`echo "$(top_srcdir)" | sed 's|.|.|g'`; \ + list='$(DISTFILES)'; for file in $$list; do \ + case $$file in \ + $(srcdir)/*) file=`echo "$$file" | sed "s|^$$srcdirstrip/||"`;; \ + $(top_srcdir)/*) file=`echo "$$file" | sed "s|^$$topsrcdirstrip/|$(top_builddir)/|"`;; \ + esac; \ + if test -f $$file || test -d $$file; then d=.; else d=$(srcdir); fi; \ + dir=`echo "$$file" | sed -e 's,/[^/]*$$,,'`; \ + if test "$$dir" != "$$file" && test "$$dir" != "."; then \ + dir="/$$dir"; \ + $(mkdir_p) "$(distdir)$$dir"; \ + else \ + dir=''; \ + fi; \ + if test -d $$d/$$file; then \ + if test -d $(srcdir)/$$file && test $$d != $(srcdir); then \ + cp -pR $(srcdir)/$$file $(distdir)$$dir || exit 1; \ + fi; \ + cp -pR $$d/$$file $(distdir)$$dir || exit 1; \ + else \ + test -f $(distdir)/$$file \ + || cp -p $$d/$$file $(distdir)/$$file \ + || exit 1; \ + fi; \ + done +check-am: all-am +check: check-am +all-am: Makefile $(DATA) +installdirs: + for dir in "$(DESTDIR)$(appmandir)"; do \ + test -z "$$dir" || $(mkdir_p) "$$dir"; \ + done +install: install-am +install-exec: install-exec-am +install-data: install-data-am +uninstall: uninstall-am + +install-am: all-am + @$(MAKE) $(AM_MAKEFLAGS) install-exec-am install-data-am + +installcheck: installcheck-am +install-strip: + $(MAKE) $(AM_MAKEFLAGS) INSTALL_PROGRAM="$(INSTALL_STRIP_PROGRAM)" \ + install_sh_PROGRAM="$(INSTALL_STRIP_PROGRAM)" INSTALL_STRIP_FLAG=-s \ + `test -z '$(STRIP)' || \ + echo "INSTALL_PROGRAM_ENV=STRIPPROG='$(STRIP)'"` install +mostlyclean-generic: + +clean-generic: + -test -z "$(CLEANFILES)" || rm -f $(CLEANFILES) + +distclean-generic: + -test -z "$(CONFIG_CLEAN_FILES)" || rm -f $(CONFIG_CLEAN_FILES) + +maintainer-clean-generic: + @echo "This command is intended for maintainers to use" + @echo "it deletes files that may require special tools to rebuild." +clean: clean-am + +clean-am: clean-generic mostlyclean-am + +distclean: distclean-am + -rm -f Makefile +distclean-am: clean-am distclean-generic + +dvi: dvi-am + +dvi-am: + +html: html-am + +info: info-am + +info-am: + +install-data-am: install-appmanDATA + +install-exec-am: + +install-info: install-info-am + +install-man: + +installcheck-am: + +maintainer-clean: maintainer-clean-am + -rm -f Makefile +maintainer-clean-am: distclean-am maintainer-clean-generic + +mostlyclean: mostlyclean-am + +mostlyclean-am: mostlyclean-generic + +pdf: pdf-am + +pdf-am: + +ps: ps-am + +ps-am: + +uninstall-am: uninstall-appmanDATA uninstall-info-am + +.PHONY: all all-am check check-am clean clean-generic distclean \ + distclean-generic distdir dvi dvi-am html html-am info info-am \ + install install-am install-appmanDATA install-data \ + install-data-am install-exec install-exec-am install-info \ + install-info-am install-man install-strip installcheck \ + installcheck-am installdirs maintainer-clean \ + maintainer-clean-generic mostlyclean mostlyclean-generic pdf \ + pdf-am ps ps-am uninstall uninstall-am uninstall-appmanDATA \ + uninstall-info-am + + +.man.$(APP_MAN_SUFFIX): + $(AM_V_GEN)$(SED) $(MAN_SUBSTS) < $< > $@ +# Tell versions [3.59,3.63) of GNU make to not export all variables. +# Otherwise a system limit (for SysV at least) may be exceeded. +.NOEXPORT: diff --git a/app/xfs/man/xfs.man b/app/xfs/man/xfs.man new file mode 100644 index 000000000..08c9c54cb --- /dev/null +++ b/app/xfs/man/xfs.man @@ -0,0 +1,389 @@ +.\" +.\" Copyright 1991, 1998 The Open Group +.\" +.\" Permission to use, copy, modify, distribute, and sell this software and its +.\" documentation for any purpose is hereby granted without fee, provided that +.\" the above copyright notice appear in all copies and that both that +.\" copyright notice and this permission notice appear in supporting +.\" documentation. +.\" +.\" The above copyright notice and this permission notice shall be included in +.\" all copies or substantial portions of the Software. +.\" +.\" THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR +.\" IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, +.\" FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL +.\" THE OPEN GROUP BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, +.\" WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF +.\" OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE +.\" SOFTWARE. +.\" +.\" Except as contained in this notice, the name of The Open Group shall not +.\" be used in advertising or otherwise to promote the sale, use or other +.\" dealing in this Software without prior written authorization from the +.\" The Open Group. +.\" Copyright 1991 Network Computing Devices +.\" +.\" Permission to use, copy, modify, distribute, and sell this software and +.\" its documentation for any purpose is hereby granted without fee, provided +.\" that the above copyright notice appear in all copies and that both that +.\" copyright notice and this permission notice appear in supporting +.\" documentation, and that the name of Network Computing Devices +.\" not be used in advertising or +.\" publicity pertaining to distribution of the software without specific, +.\" written prior permission. Network Computing Devices make +.\" no representations about the +.\" suitability of this software for any purpose. It is provided "as is" +.\" without express or implied warranty. +.TH xfs __appmansuffix__ __xorgversion__ +.SH NAME +xfs \- X font server +.SH SYNOPSIS +.B xfs +[ +.BI "\-config " configuration_file +] +[ +.B \-daemon +] +[ +.B \-droppriv +] +[ +.B \-inetd +] +[ +.BI "\-ls " listen_socket +] +[ +.B \-nodaemon +] +[ +.BI "\-port " tcp_port +] +[ +.BI "\-user " username +] +.SH DESCRIPTION +.B xfs +is the X Window System font server. +It supplies fonts to X Window System display servers. +The server is usually run by a system administrator, and started via +.BR init (__adminmansuffix__) +or +.BR inetd (__adminmansuffix__). +Users may also wish to start private font servers for specific sets of +fonts. +.PP +To connect to a font server, see the documentation for your X server; it +likely supports the syntax documented in the \(lqFONT SERVER NAMES\(rq +section of +.BR X (__miscmansuffix__). +.SH OPTIONS +.TP +.BI "\-config " configuration_file +specifies the configuration file +.B xfs +will use. +If this parameter is not specified, xfs will read its configuration from +__configfiledesc__ +.IR __configfilepath__ . +.TP +.B \-daemon +instructs +.B xfs +to fork and go into the background automatically at startup. +If this option is not specified, +.B xfs +will run as a regular process (unless it was built to daemonize by +default). +When running as a daemon, +.B xfs +will attempt to create a file in which it stores its process ID, and will +delete that file upon exit; +.TP +.B \-droppriv +instructs +.B xfs +to attempt to run as user and group +.I xfs +(unless the +.B \-user +option is used). +This has been implemented for security reasons, as +.B xfs +may have undiscovered buffer overflows or other paths for possible exploit, +both local and remote. +When using this option, you may also wish to specify \(oqno\-listen = +tcp\(cq in the config file, which ensures that +.B xfs +will not to use a TCP port at all. +By default, +.B xfs +runs with the user and group IDs of the user who invoked it. +.TP +.B \-inetd +informs +.B xfs +that it is being started by inetd, and that a listening socket on the +appropriate port is being passed as standard input. Assumes that inetd +is configured to "wait" mode, and will thus allow xfs to handle +listening for and accepting further connections on this port. This allows +xfs to be started on demand when the first font client connects. +When using this option, the -daemon and -port flags are ignored. +.TP +.BI "\-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 additional +connections. +.TP +.B \-nodaemon +instructs +.B xfs +not to daemonize (fork and detach from its controlling terminal). +This option only has an effect if +.B xfs +is built to daemonize by default, which is not the stock configuration. +.TP +.BI "\-port " tcp_port +specifies the TCP port number on which the server will listen for +connections. +The default port number is 7100. +This option is ignored if +.B xfs +is configured to not listen to TCP transports at all (see \(lqConfiguration +File Format\(rq below). +.TP +.BI "\-user " username +instructs +.B xfs +to run as the user +.IR username. +See +.B \-droppriv +for why this may be desired. +By default, +.B xfs +runs with the user and group IDs of the user who invoked it. +.SH "INPUT FILES" +.B xfs +reads and serves any font file format recognized by the X server itself. +It locates font files through the specification of a +.IR catalogue , +which is declared in +.BR xfs 's +configuration file. +.SS "Configuration File Format" +.B xfs +reads its configuration from a text file (see the +.B \-config +option in the \(lqOPTIONS\(rq section above). +The configuration language is a list of keyword and value pairs. +Each keyword is followed by an equals sign (\(oq=\(cq) and then the desired +value. +.PP +Recognized keywords include: +.TP +.BR alternate\-servers " (list of \fIstring\fPs)" +lists alternate servers for this font server. +See the \(lqFONT SERVER NAMES\(rq section of +.BR X (__miscmansuffix__) +for the syntax of the string. +.\" .TP +.\" .BR cache\-size " (\fIcardinal\fP)" +.\" determines the size (in bytes) of the font server cache. +.TP +.BR catalogue " (list of \fIstring\fPs)" +declares as ordered list of font path element names from which fonts will +be served. +The current implementation only supports a single catalogue ("all") +containing all of the specified fonts. A special directory with +symlinks to font paths can be specified using a catalogue: +entry. See the CATALOGUE DIR section below for details. +.TP +.BR client\-limit " (\fIcardinal\fP)" +determines the number of clients this font server will support before +refusing service. +This is useful for tuning the load on each individual font server. +.TP +.BR clone\-self " (\fIboolean\fP)" +indicates whether this font server should attempt to clone itself when the +number of connected clients reaches the +.BR client\-limit . +.TP +.BR default\-point\-size " (\fIcardinal\fP)" +The default pointsize (in decipoints) for font requests that don't specify +a point size. +The default is 120. +.TP +.BR default\-resolutions " (list of \fIresolution\fPs)" +indicates the resolutions the server supports by default. +This information may be used as a hint for pre-rendering, and substituted +into requests for scaled fonts which do not specify a resolution. +A +.I resolution +is a comma-separated pair of horizontal and vertical resolutions in pixels +per inch. +Multiple resolutions are separated by commas. +.TP +.BR deferglyphs " (\fIstring\fP)" +sets the mode for delayed fetching and caching of glyphs. +.I string +should be one of \(oqnone\(cq, meaning glyphs deferment is disabled, +\(oqall\(cq, meaning it is enabled for all fonts, and \(oq16\(cq, meaning +it is enabled only for 16-bit fonts. +.TP +.BR error\-file " (\fIstring\fP)" +indicates the filename of the error file. +All warnings and errors will be logged here, unless +.B use\-syslog +is set to a true value (see below). +.TP +.BR no\-listen " (\fItrans-type\fP)" +disables the specified transport type. +For example, TCP/IP connections can be disabled with \(oqno\-listen = +tcp\(cq. +.TP +.BR port " (\fIcardinal\fP)" +indicates the TCP port on which the server will listen for connections. +.\" .TP +.\" .BR trusted-clients " (list of \fIstring\fPs)" +.\" identifies the clients the font server will talk to. +.\" Others will be refused for the initial connection. +.\" An empty list means the server will talk to any client. +.TP +.BR use\-syslog " (\fIboolean\fP)" +determines whether errors and diagnostics should be reported via +.BR syslog (__libmansuffix__) +(on supported systems) instead of being written to the +.B error\-file +(see above). +.SH "CATALOGUE DIR" +You can specify a special kind of font path in the form \fBcatalogue:\fR. +The directory specified after the catalogue: prefix will be scanned for symlinks +and each symlink destination will be added as a local fontfile FPE. +.PP +The symlink can be suffixed by attributes such as '\fBunscaled\fR', which +will be passed through to the underlying fontfile FPE. The only exception is +the newly introduced '\fBpri\fR' attribute, which will be used for ordering +the font paths specified by the symlinks. + +An example configuration: + +.nf + 75dpi:unscaled:pri=20 \-> /usr/share/X11/fonts/75dpi + ghostscript:pri=60 \-> /usr/share/fonts/default/ghostscript + misc:unscaled:pri=10 \-> /usr/share/X11/fonts/misc + type1:pri=40 \-> /usr/share/X11/fonts/Type1 + type1:pri=50 \-> /usr/share/fonts/default/Type1 +.fi + +This will add /usr/share/X11/fonts/misc as the first FPE with the attribute +'unscaled', second FPE will be /usr/share/X11/fonts/75dpi, also with +the attribute unscaled etc. This is functionally equivalent to setting +the following font path: + +.nf + /usr/share/X11/fonts/misc:unscaled, + /usr/share/X11/fonts/75dpi:unscaled, + /usr/share/X11/fonts/Type1, + /usr/share/fonts/default/Type1, + /usr/share/fonts/default/ghostscript +.fi +.SS "Example Configuration File" +.nf + # + # sample font server configuration file + # + + # allow a max of 10 clients to connect to this font server. + client\-limit = 10 + + # When a font server reaches the above limit, start up a new one. + clone\-self = on + + # Identify alternate font servers for clients to use. + alternate\-servers = hansen:7101,hansen:7102 + + # Look for fonts in the following directories. The first is a set of + # TrueType outlines, the second is a set of misc bitmaps (such as terminal + # and cursor fonts), and the last is a set of 100dpi bitmaps. + # + catalogue = /usr/share/X11/fonts/TTF, + /usr/share/X11/fonts/misc, + /usr/share/X11/fonts/100dpi/ + + # in 12 points, decipoints + default\-point\-size = 120 + + # 100 x 100 and 75 x 75 + default\-resolutions = 100,100,75,75 + + # Specify our log filename. + error\-file = /var/log/xfs.log + + # Direct diagnostics to our own log file instead of using syslog. + use\-syslog = off +.fi +.SH "OUTPUT FILES" +When operating in daemon mode, +.B xfs +sends diagnostic messages (errors and warnings) to the log file +specified by the +.B error-file +configuration variable by default. +However, these messages can be sent to an alternate location via the +.B error\-file +and +.B use\-syslog +configuration variables; see \(lqConfiguration File Format\(rq, above. +.SH "ASYNCHRONOUS EVENTS" +.B xfs +handles the following signals specially: +.TP +.I SIGTERM +causes the font server to exit cleanly. +.TP +.I SIGUSR1 +causes +.B xfs +to re-read its configuration file. +.TP +.I SIGUSR2 +causes +.B xfs +to flush any cached data it may have. +.TP +.I SIGHUP +causes +.B xfs +to reset, closing all active connections and re-reading the configuration +file. +.SH BUGS +Multiple catalogues should be supported. +.SH "FUTURE DIRECTIONS" +Significant further development of +.B xfs +is unlikely. +One of the original motivations behind it was the single-threaded nature of +the X server \(em a user's X session could seem to \(oqfreeze up\(cq while +the X server took a moment to rasterize a font. +This problem with the X server, which remains single-threaded in all +popular implementations to this day, has been mitigated on two fronts: +machines have gotten much faster, and client-side font rendering +(particularly via the Xft library) is the norm in contemporary software. +.SH AUTHORS +Dave Lemke, Network Computing Devices, Inc +.br +Keith Packard, Massachusetts Institute of Technology +.SH "SEE ALSO" +.BR X (__miscmansuffix__), +.BR xfsinfo (__appmansuffix__), +.BR fslsfonts (__appmansuffix__), +.BR init (__adminmansuffix__), +.BR inetd (__adminmansuffix__), +.BR syslog (__libmansuffix__), +.IR "The X Font Service Protocol" , +.I Font Server Implementation Overview -- cgit v1.2.3