gnome-system-log(1)					      General Commands Manual					       gnome-system-log(1)

NAME

       gnome-system-log - the GNOME System Log Viewer

SYNOPSIS

       gnome-system-log

       or select System Log from the System Tools submenu of the Applications menu.

DESCRIPTION

       GNOME System Log Viewer is a simple utility to display system log files.

AUTHOR

       The GNOME System Log Viewer was written by Cesar Miquel <miquel@df.uba.ar>.

       GNOME System Log Viewer Plugin Interface was written by Lin Ma <lin.ma@sun.com>.

       This manual page was written by Jochen Voss <voss@mathematik.uni-kl.de>.

       Plugin Service Provider Interface (SPI)
	      We have provided an SPI for adding plugins into Gnome Log Viewer. The SPI mainly includes three parts:

	      I/O (LogviewIFaceIO)
		     This defines the main input interface. This is used by Log Viewer to read a logs content into memory, whether the logs source
		     is text or binary, the data returned here should be text - most likely in the current locale. It  also  provides  methods	to
		     allow the main application to get other information about the log such as whether the log has changed.

		     It's  the	reposibility of the plugin to maintain information about the log file(s) such as the current location in the file,
		     the size of the file, etc.

	      Views (LogviewIFaceView)
		     This interface defines a mechanism to enable the formatting of log data, dividing it into lines. The  current  implementation
		     defines how to group lines by date and the conversion of the log from the current locale to UTF-8.

	      Collectors (LogviewIFaceCollector)
		     This interface is used to gather the list of logs. New types of logs may be added using this interface.

       For the detail information, please see /usr/share/gtk-doc/html/logview/index.html.

       Plugin Priority
	      A  priority  list is maintained for each category of plugin - this defines the order in which plugins will be used - higher priority
	      plugins override lower priority plugins. Priorities are categorised as:

	      Priority 0-9: Used by the delivered default plugins
	      Priority 10+: End Users plugins.

       Plugin Search Path
	      Log Viewer will search in the following directories for plugins:

	      $HOME/.gnome2/gnome-system-log/plugins/`uname -p`
	      /lib/gnome-system-log/plugins

       Plugin Security
	      Both libgrablogs and libpipelog only recognize the configure file which has the same owner ship to the  user,  otherwise	they  will
	      back  to	the  system  default  ones.  In Solaris, they will use a fork/exec/pfsh to run the commands within the configure files; in
	      Linux, they will use popen(3).

       Default Plugins
	      Three plugins are available for the end-users. They are libgrablogs.so, libplainlog.so and libpipelog.so.

FILES

       /usr/lib/gnome-system-log/plugins/libgrablogs.so
	      A default plugin - collecting some log files from system. See grablogs.conf (4).

       /usr/lib/gnome-system-log/plugins/libplainlog.so
	      A default plugin - view ASCII log files.

       /usr/lib/gnome-system-log/plugins/libpipelog.so
	      A default plugin - has a higher priority than libplainlog.so, view the output of a command. See pipelog.conf (4).

       /var/log/messages
	      The system's main logfile.

       /etc/syslog.conf
	      Configuration file for syslogd.  See syslog.conf(5) for exact information.

ATTRIBUTES

       See attributes(5) for descriptions of the following attributes:

       +----------------------------------+-----------------------------+
       | ATTRIBUTE TYPE^ATTRIBUTE VALUE   |				|
       +----------------------------------+-----------------------------+
       |Availability^SUNWgnome-log-viewer |				|
       +----------------------------------+-----------------------------+
       |Interface stability^GVolatile	  |				|
       +----------------------------------+-----------------------------+

SEE ALSO

       syslogd(8), sysklogd(8), syslog.conf(5), syslogd-listfiles(8), grablogs.conf(4), pipelog.conf(4)

gnome-utils 2.16.0						    Aug 09 2002 					       gnome-system-log(1)