XQuartz: Add a LOGGING section to our man page

Signed-off-by: Jeremy Huddleston <jeremyhu@apple.com>
This commit is contained in:
Jeremy Huddleston 2011-05-12 15:45:29 -07:00
parent c18b7165f9
commit 5bc05d96f8

View File

@ -102,9 +102,32 @@ Same as fake_button3 above.
.TP 8 .TP 8
.B "\-depth \fIdepth\fP" .B "\-depth \fIdepth\fP"
Same as depth above. Same as depth above.
.SH LOGGING
XQuartz stores a server log at ~/Library/Logs/X11.__bundle_id_prefix__.log which
is analogous to /var/log/Xorg.#.log on systems that use the XFree86 DDX such as
Linux, BSD, and Solaris.
.PP
In addition to this server log, XQuartz sends messages to syslogd(8) using
asl(3). These logs are sent to the __bundle_id_prefix__ facility, and you can
watch these logs using the following syslog(1) command:
.TP 8
.B $ syslog -w -k Facility __bundle_id_prefix__
.PP
By default, XQaurtz sets an ASL mask which prevents it from logging messages
below the ASL_LEVEL_WARNING level (meaning almost all logging is done strictly
to the file referenced above). To force XQuartz to send all log messages to
syslogd(8), you can adjust this mask using the following syslog(1) command:
.TP 8
.B $ syslog -c X11.bin -d
.PP
The stdout and stderr messages printed by any process launched by XQuartz will
be redirected to this syslog facility with a priority level of ASL_LEVEL_INFO
and ASL_LEVEL_NOTICE respectively. In order to see these messages in syslog,
you will need to adjust XQuartz's asl mask as above but using -i or -n
instead of -d.
.SH "SEE ALSO" .SH "SEE ALSO"
.PP .PP
X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1) X(__miscmansuffix__), Xserver(1), xdm(1), xinit(1), syslog(1), syslogd(8)
.PP .PP
http://xquartz.macosforge.org http://xquartz.macosforge.org
.PP .PP