/jds/bin/diff -uprN gnome-utils-2.25.90.old/logview/data/gnome-system-log.1 gnome-utils-2.25.90/logview/data/gnome-system-log.1
--- gnome-utils-2.25.90.old/logview/data/gnome-system-log.1 2009-02-10 16:55:36.147962000 +0000
+++ gnome-utils-2.25.90/logview/data/gnome-system-log.1 2009-02-10 17:01:01.284029000 +0000
@@ -1,6 +1,7 @@
.\" gnome-system-log.1 - GNOME logfile viewer
.\" Copyright 2001 Jochen Voss
-.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.0.0"
+'\" te
+.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.26.0"
.SH NAME
gnome-system-log \- the GNOME System Log Viewer
.SH SYNOPSIS
@@ -19,10 +20,76 @@ The
.B GNOME System Log Viewer
was written by Cesar Miquel <miquel@df.uba.ar>.
.PP
+.B GNOME System Log Viewer Plugin Interface
+was written by Lin Ma <lin.ma@sun.com>.
+.PP
This manual page was written by Jochen Voss
<voss@mathematik.uni-kl.de>.
+.TP
+.B 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.
+.TP
+.B 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.
+.TP
+.B Collectors (LogviewIFaceCollector)
+This interface is used to gather the list of logs. New types of logs
+may be added using this interface.
+.RE
+
+For the detail information, please see /usr/share/gtk-doc/html/logview/index.html.
+.TP
+.B 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:
+
+.br
+Priority 0-9: Used by the delivered default plugins
+.br
+Priority 10+: End Users plugins.
+.TP
+.B Plugin Search Path
+Log Viewer will search in the following directories for plugins:
+
+.br
+$HOME/.gnome2/gnome-system-log/plugins/`uname -p`
+.br
+.TP
+.B 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).
+.TP
+.B Default Plugins
+Three plugins are available for the end-users. They are libgrablogs.so,
.SH FILES
.TP
+A default plugin - collecting some log files from system. See grablogs.conf (4).
+.TP
+A default plugin - view ASCII log files.
+.TP
+A default plugin - has a higher priority than libplainlog.so, view the output
+of a command. See pipelog.conf (4).
+.TP
The system's main logfile.
.TP
@@ -30,8 +97,27 @@ The system's main logfile.
Configuration file for syslogd. See
.BR syslog.conf (5)
for exact information.
+.RE
+
+.SH ATTRIBUTES
+.sp
+.PP
+See \fBattributes\fR(5) for descriptions of the following attributes:
+
+.TS
+tab(^G) allbox;
+cw(2.750000i)| cw(2.750000i)
+lw(2.750000i)| lw(2.750000i).
+ATTRIBUTE TYPE^ATTRIBUTE VALUE
+Availability^SUNWgnome-log-viewer
+Interface stability^GVolatile
+.TE
+
.SH SEE ALSO
.BR syslogd (8),
.BR sysklogd (8),
.BR syslog.conf (5),
-.BR syslogd-listfiles (8)
+.BR syslogd-listfiles (8),
+.BR grablogs.conf (4),
+.BRE pipelog.conf (4)
+.\" LSARC 2006/325 Gnome System Log Viewer
/jds/bin/diff -uprN gnome-utils-2.25.90.old/logview/data/grablogs.conf.4 gnome-utils-2.25.90/logview/data/grablogs.conf.4
--- gnome-utils-2.25.90.old/logview/data/grablogs.conf.4 1970-01-01 01:00:00.000000000 +0100
+++ gnome-utils-2.25.90/logview/data/grablogs.conf.4 2009-02-10 17:02:03.311007000 +0000
@@ -0,0 +1,79 @@
+'\" te
+.\" gnome-system-log.1 - GNOME logfile viewer
+.\" Copyright 1989 AT
+.\"|[amp ]
+.\"|T
+.\" Copyright 2006 Lin Ma
+.TH grablogs.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
+.SH "NAME"
+grablogs.conf \- grablogs configuration for libgrablogs.so of the plugins of
+ gnome-system-log
+file
+.SH "SYNOPSIS"
+.PP
+.nf
+.fi
+.SH "DESCRIPTION"
+.PP
+The libgrablogs.so is a plugin for gnome-system-log(1), it colloct the log
+files from the system as many as possible. grablogs.conf is a configuration
+file that contains a set of lines mixed with sh(1) syntax codes and individual
+ log files. libgrablogs.so will read the file try to get a log files list for
+ gnome-system-log(1). Users can copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to overwrite the system default one.
+.PP
+The grablogs.conf file contains the following configuration categories:
+.RS
+.TP
+.B [configs]
+Each line under this category is interpreted as a config file of
+System. The plugin will open the config file and try to find all
+system paths of the logs.
+.TP
+.B [commands]
+Each line under this category is interpreted as a shell command and
+will be execute through a pipe. And each line of the output of the
+command will be interpreted as a log path.
+.TP
+.B [logs]
+Each line under this category is interpreted as a log path.
+.RE
+.SH "FILES"
+.TP
+The system default configuration file for the plugin libgrablogs.so
+.TP
+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/grablogs.conf"
+The user specific configuration file for the plugin libgrablogs.so
+.SH "EMAMPLE"
+.br
+.B [configs]
+.br
+.IR /etc/syslog.conf
+.br
+.B [commands]
+.br
+.IR "for i in `svcs -aH -o FMRI | grep -v lrc `; do svcprop -p restarter/logfile $i 2>/dev/null || svcprop -q -p restarter/alt_logfile $i 2>/dev/null ; done"
+.br
+.B [logs]
+.br
+.IR /var/log/messages
+.br
+.IR /var/log/secure
+.br
+.IR /var/log/maillog
+.br
+.IR /var/log/cron
+.br
+.IR /var/log/Xorg.0.log
+.br
+.br
+.IR /var/log/auth.log
+.br
+.SH "SEE ALSO"
+.PP
+.BR gnome-system-log (1),
+.BR pipelog.conf (1)
+.PP
/jds/bin/diff -uprN gnome-utils-2.25.90.old/logview/data/pipelog.conf.4 gnome-utils-2.25.90/logview/data/pipelog.conf.4
--- gnome-utils-2.25.90.old/logview/data/pipelog.conf.4 1970-01-01 01:00:00.000000000 +0100
+++ gnome-utils-2.25.90/logview/data/pipelog.conf.4 2009-02-10 17:02:51.656120000 +0000
@@ -0,0 +1,49 @@
+'\" te
+.\" gnome-system-log.1 - GNOME logfile viewer
+.\" Copyright 1989 AT
+.\"|[amp ]
+.\"|T
+.\" Copyright 2006 Lin Ma
+.TH pipelog.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
+.SH "NAME"
+pipelog.conf \- pipelog configuration for libpipelog.so of the plugins of
+gnome-system-log
+file
+.SH "SYNOPSIS"
+.PP
+.nf
+.fi
+.SH "DESCRIPTION"
+.PP
+The libpipelog.so is a plugin for gnome-system-log(1), it runs commands through
+ pipes and get the output of the individual pipe as a log content. Users can
+ copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to
+ overwrite the system default one.
+.PP
+The syntax of pipelog.conf file is:
+.br
+.RS .5i
+<log path><whitespace><command>
+
+.RE
+<command> may be a simple program name (which will be found in $PATH)
+or an absolute path of a binary with arguments list. "%s" can be included in
+<command> zero or one time, will be replaced by <log path> in runtime.
+.SH "FILES"
+.TP
+The system default configuration file for the plugin libpipelog.so
+.TP
+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/pipelog.conf"
+The user specific configuration file for the plugin libpipelog.so
+.SH "EMAMPLE"
+.IR "/var/adm/wtmpx last"
+.br
+.IR "/var/adm/utmpx /bin/last -f %s"
+.SH "SEE ALSO"
+.PP
+.BR gnome-system-log (1),
+.BR grablogs.conf (4)
+.PP
+.\" LSARC 2006/325 Gnome System Log Viewer