15987N/AIndex: logview/grablogs.conf.4
15987N/A===================================================================
15987N/A--- logview/grablogs.conf.4 (revision 0)
15987N/A+++ logview/grablogs.conf.4 (revision 0)
15987N/A@@ -0,0 +1,79 @@
15987N/A+'\" te
15987N/A+.\" gnome-system-log.1 - GNOME logfile viewer
15987N/A+.\" Copyright 1989 AT
15987N/A+.\"|[amp ]
15987N/A+.\"|T
15987N/A+.\" Copyright 2006 Lin Ma
15987N/A+.TH grablogs.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
15987N/A+.SH "NAME"
15987N/A+grablogs.conf \- grablogs configuration for libgrablogs.so of the plugins of
15987N/A+ gnome-system-log
15987N/A+file
15987N/A+.SH "SYNOPSIS"
15987N/A+.PP
15987N/A+.nf
15987N/A+/usr/lib/gnome-system-log/plugins/grablogs.conf
15987N/A+.fi
15987N/A+.SH "DESCRIPTION"
15987N/A+.PP
15987N/A+The libgrablogs.so is a plugin for gnome-system-log(1), it colloct the log
15987N/A+files from the system as many as possible. grablogs.conf is a configuration
15987N/A+file that contains a set of lines mixed with sh(1) syntax codes and individual
15987N/A+ log files. libgrablogs.so will read the file try to get a log files list for
15987N/A+ gnome-system-log(1). Users can copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to overwrite the system default one.
15987N/A+.PP
15987N/A+The grablogs.conf file contains the following configuration categories:
15987N/A+.RS
15987N/A+.TP
15987N/A+.B [configs]
15987N/A+Each line under this category is interpreted as a config file of
15987N/A+System. The plugin will open the config file and try to find all
15987N/A+system paths of the logs.
15987N/A+.TP
15987N/A+.B [commands]
15987N/A+Each line under this category is interpreted as a shell command and
15987N/A+will be execute through a pipe. And each line of the output of the
15987N/A+command will be interpreted as a log path.
15987N/A+.TP
15987N/A+.B [logs]
15987N/A+Each line under this category is interpreted as a log path.
15987N/A+.RE
15987N/A+.SH "FILES"
15987N/A+.TP
15987N/A+.I /usr/lib/gnome-system-log/plugins/grablogs.conf
15987N/A+The system default configuration file for the plugin libgrablogs.so
15987N/A+.TP
15987N/A+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/grablogs.conf"
15987N/A+The user specific configuration file for the plugin libgrablogs.so
15987N/A+.SH "EMAMPLE"
15987N/A+.br
15987N/A+.B [configs]
15987N/A+.br
15987N/A+.IR /etc/syslog.conf
15987N/A+.br
15987N/A+.B [commands]
15987N/A+.br
15987N/A+.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"
15987N/A+.br
15987N/A+.B [logs]
15987N/A+.br
15987N/A+.IR /var/log/messages
15987N/A+.br
15987N/A+.IR /var/log/secure
15987N/A+.br
15987N/A+.IR /var/log/maillog
15987N/A+.br
15987N/A+.IR /var/log/cron
15987N/A+.br
15987N/A+.IR /var/log/Xorg.0.log
15987N/A+.br
15987N/A+.IR /var/log/XFree86.0.log
15987N/A+.br
15987N/A+.IR /var/log/auth.log
15987N/A+.br
15987N/A+.IR /var/log/cups/error_log
15987N/A+.SH "SEE ALSO"
15987N/A+.PP
15987N/A+.BR gnome-system-log (1),
15987N/A+.BR pipelog.conf (1)
15987N/A+.PP
15987N/AIndex: logview/pipelog.conf.4
15987N/A===================================================================
15987N/A--- logview/pipelog.conf.4 (revision 0)
15987N/A+++ logview/pipelog.conf.4 (revision 0)
15987N/A@@ -0,0 +1,49 @@
15987N/A+'\" te
15987N/A+.\" gnome-system-log.1 - GNOME logfile viewer
15987N/A+.\" Copyright 1989 AT
15987N/A+.\"|[amp ]
15987N/A+.\"|T
15987N/A+.\" Copyright 2006 Lin Ma
15987N/A+.TH pipelog.conf 4 "13 Oct 2006" "gnome-utils 2.16.0" "File Formats"
15987N/A+.SH "NAME"
15987N/A+pipelog.conf \- pipelog configuration for libpipelog.so of the plugins of
15987N/A+gnome-system-log
15987N/A+file
15987N/A+.SH "SYNOPSIS"
15987N/A+.PP
15987N/A+.nf
15987N/A+/usr/lib/gnome-system-log/plugins/pipelog.conf
15987N/A+.fi
15987N/A+.SH "DESCRIPTION"
15987N/A+.PP
15987N/A+The libpipelog.so is a plugin for gnome-system-log(1), it runs commands through
15987N/A+ pipes and get the output of the individual pipe as a log content. Users can
15987N/A+ copy the file into $HOME/.gnome2/gnome-system-log/plugins/`uname -p` to
15987N/A+ overwrite the system default one.
15987N/A+.PP
15987N/A+The syntax of pipelog.conf file is:
15987N/A+.br
15987N/A+.RS .5i
15987N/A+<log path><whitespace><command>
15987N/A+
15987N/A+.RE
15987N/A+<command> may be a simple program name (which will be found in $PATH)
15987N/A+or an absolute path of a binary with arguments list. "%s" can be included in
15987N/A+<command> zero or one time, will be replaced by <log path> in runtime.
15987N/A+.SH "FILES"
15987N/A+.TP
15987N/A+.I /usr/lib/gnome-system-log/plugins/pipelog.conf
15987N/A+The system default configuration file for the plugin libpipelog.so
15987N/A+.TP
15987N/A+.I "$HOME/.gnome2/gnome\-system\-log/plugins/`uname \-p`/pipelog.conf"
15987N/A+The user specific configuration file for the plugin libpipelog.so
15987N/A+.SH "EMAMPLE"
15987N/A+.IR "/var/adm/wtmpx last"
15987N/A+.br
15987N/A+.IR "/var/adm/utmpx /bin/last -f %s"
15987N/A+.SH "SEE ALSO"
15987N/A+.PP
15987N/A+.BR gnome-system-log (1),
15987N/A+.BR grablogs.conf (4)
15987N/A+.PP
15987N/A+.\" LSARC 2006/325 Gnome System Log Viewer
16939N/Adiff -ruN gnome-utils-2.27.2.orig/logview/data/gnome-system-log.1 gnome-utils-2.27.2/logview/data/gnome-system-log.1
16939N/A--- gnome-utils-2.27.2.orig/logview/data/gnome-system-log.1 2009-07-31 13:03:43.589752351 +0100
16939N/A+++ gnome-utils-2.27.2/logview/data/gnome-system-log.1 2009-07-31 13:07:40.320623516 +0100
16939N/A@@ -1,6 +1,7 @@
16939N/A+'\" te
16939N/A .\" gnome-system-log.1 - GNOME logfile viewer
16939N/A .\" Copyright 2001 Jochen Voss
16939N/A-.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.0.0"
16939N/A+.TH gnome-system-log 1 "Aug 09 2002" "gnome-utils 2.16.0"
16939N/A .SH NAME
16939N/A gnome-system-log \- the GNOME System Log Viewer
16939N/A .SH SYNOPSIS
16939N/A@@ -19,10 +20,81 @@
16939N/A .B GNOME System Log Viewer
16939N/A was written by Cesar Miquel <miquel@df.uba.ar>.
16939N/A .PP
16939N/A+.B GNOME System Log Viewer Plugin Interface
16939N/A+was written by Lin Ma <lin.ma@sun.com>.
16939N/A+.PP
16939N/A This manual page was written by Jochen Voss
16939N/A <voss@mathematik.uni-kl.de>.
16939N/A+.TP
16939N/A+.B Plugin Service Provider Interface (SPI)
16939N/A+We have provided an SPI for adding plugins into Gnome Log Viewer. The SPI
16939N/A+mainly includes three parts:
16939N/A+.RS
16939N/A+.TP
16939N/A+.B I/O (LogviewIFaceIO)
16939N/A+This defines the main input interface. This is used by Log Viewer to
16939N/A+read a logs content into memory, whether the logs source is text or
16939N/A+binary, the data returned here should be text - most likely in the
16939N/A+current locale. It also provides methods to allow the main application
16939N/A+to get other information about the log such as whether the log has
16939N/A+changed.
16939N/A+
16939N/A+It's the reposibility of the plugin to maintain information about the
16939N/A+log file(s) such as the current location in the file, the size of the
16939N/A+file, etc.
16939N/A+.TP
16939N/A+.B Views (LogviewIFaceView)
16939N/A+This interface defines a mechanism to enable the formatting of log
16939N/A+data, dividing it into lines. The current implementation defines how to
16939N/A+group lines by date and the conversion of the log from the current
16939N/A+locale to UTF-8.
16939N/A+.TP
16939N/A+.B Collectors (LogviewIFaceCollector)
16939N/A+This interface is used to gather the list of logs. New types of logs
16939N/A+may be added using this interface.
16939N/A+.RE
16939N/A+
16939N/A+For the detail information, please see /usr/share/gtk-doc/html/logview/index.html.
16939N/A+.TP
16939N/A+.B Plugin Priority
16939N/A+ priority list is maintained for each category of plugin - this defines
16939N/A+the order in which plugins will be used - higher priority plugins override
16939N/A+lower priority plugins. Priorities are categorised as:
16939N/A+
16939N/A+.br
16939N/A+Priority 0-9: Used by the delivered default plugins
16939N/A+.br
16939N/A+Priority 10+: End Users plugins.
16939N/A+.TP
16939N/A+.B Plugin Search Path
16939N/A+Log Viewer will search in the following directories for plugins:
16939N/A+
16939N/A+.br
16939N/A+$HOME/.gnome2/gnome-system-log/plugins/`uname -p`
16939N/A+.br
16939N/A+/lib/gnome-system-log/plugins
16939N/A+.TP
16939N/A+.B Plugin Security
16939N/A+Both libgrablogs and libpipelog only recognize the configure file which has the
16939N/A+same owner ship to the user, otherwise they will back to the system default
16939N/A+ones. In Solaris, they will use a fork/exec/pfsh to run the commands within the
16939N/A+configure files; in Linux, they will use popen(3).
16939N/A+.TP
16939N/A+.B Default Plugins
16939N/A+Three plugins are available for the end-users. They are libgrablogs.so,
16939N/A+libplainlog.so and libpipelog.so.
16939N/A .SH FILES
16939N/A .TP
16939N/A+.I /usr/lib/gnome-system-log/plugins/libgrablogs.so
16939N/A+A default plugin - collecting some log files from system. See grablogs.conf (4).
16939N/A+.TP
16939N/A+.I /usr/lib/gnome-system-log/plugins/libplainlog.so
16939N/A+A default plugin - view ASCII log files.
16939N/A+.TP
16939N/A+.I /usr/lib/gnome-system-log/plugins/libpipelog.so
16939N/A+A default plugin - has a higher priority than libplainlog.so, view the output
16939N/A+of a command. See pipelog.conf (4).
16939N/A+.TP
16939N/A .I /var/log/messages
16939N/A The system's main logfile.
16939N/A .TP
16939N/A@@ -30,8 +102,27 @@
16939N/A Configuration file for syslogd. See
16939N/A .BR syslog.conf (5)
16939N/A for exact information.
16939N/A+.RE
16939N/A+
16939N/A+.SH ATTRIBUTES
16939N/A+.sp
16939N/A+.PP
16939N/A+See \fBattributes\fR(5) for descriptions of the following attributes:
16939N/A+
16939N/A+.TS
16939N/A+tab(^G) allbox;
16939N/A+cw(2.750000i)| cw(2.750000i)
16939N/A+lw(2.750000i)| lw(2.750000i).
16939N/A+ATTRIBUTE TYPE^ATTRIBUTE VALUE
16939N/A+Availability^SUNWgnome-log-viewer
16939N/A+Interface stability^GVolatile
16939N/A+.TE
16939N/A+
16939N/A .SH SEE ALSO
16939N/A .BR syslogd (8),
16939N/A .BR sysklogd (8),
16939N/A .BR syslog.conf (5),
16939N/A-.BR syslogd-listfiles (8)
16939N/A+.BR syslogd-listfiles (8),
16939N/A+.BR grablogs.conf (4),
16939N/A+.BR pipelog.conf (4)
16939N/A+.\" LSARC 2006/325 Gnome System Log Viewer