XQuartz: Add a LOGGING section to our man page
Signed-off-by: Jeremy Huddleston <jeremyhu@apple.com>
This commit is contained in:
		
							parent
							
								
									c18b7165f9
								
							
						
					
					
						commit
						5bc05d96f8
					
				|  | @ -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 | ||||||
|  |  | ||||||
		Loading…
	
		Reference in New Issue