User Commands                                 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  sys-
     tem log files.

AUTHOR
     The GNOME System Log Viewer  was  written  by  Cesar  Miquel
     .

     GNOME System Log Viewer Plugin Interface was written by  Lin
     Ma .

     This   manual   page   was   written    by    Jochen    Voss
     .

     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



gnome-utils 2.16.0  Last change: Aug 09 2002                    1






User Commands                                 gnome-system-log(1)



               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 plu-
          gin  -  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 con-
          figure  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 com-
          mands 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  sys-
          tem. See grablogs.conf (4).

     /usr/lib/gnome-system-log/plugins/libplainlog.so
          A default plugin - view ASCI 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.



gnome-utils 2.16.0  Last change: Aug 09 2002                    2






User Commands                                 gnome-system-log(1)



ATRIBUTES
     See attributes(5) for descriptions of the  following  attri-
     butes:

     
           ATRIBUTE TYPE               ATRIBUTE 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  Last change: Aug 09 2002                    3