nfslog.conf(5) 맨 페이지 - 윈디하나의 솔라나라

개요

섹션
맨 페이지 이름
검색(S)

nfslog.conf(5)

nfslog.conf(5)                   File Formats                   nfslog.conf(5)



NAME
       nfslog.conf - NFS server logging configuration file

SYNOPSIS
       /etc/nfs/nfslog.conf

DESCRIPTION
       The  nfslog.conf file specifies the location of the NFS server logs, as
       well as the location of the private work files used by the  NFS  server
       and  nfslogd(8)  daemon during logging. Each entry in the file consists
       of a mandatory tag identifier and one or  more  parameter  identifiers.
       The  parameter  identifier  specifies the value or location of the spe‐
       cific   parameter.   For    instance,    the    parameter    identifier
       "log=/var/nfs/logs/serverLog"  specifies the location of the NFS server
       activity log. The mandatory tag identifier serves as an index into  the
       /etc/nfs/nfslog.conf  file  to  identify  the  various parameters to be
       used. At export time, the share_nfs(8) command specifies the NFS server
       logging  parameters  to use by associating a tag from the /etc/nfs/nfs‐
       log.conf file to the exported file system. It is legal  for  more  than
       one file system to be exported using the same logging tag identifier.


       NFS  server logging is not supported on Solaris machines that are using
       NFS Version 4.


       A "global" tag identifier is included in /etc/nfs/nfslog.conf. It spec‐
       ifies  the  default  set of values to be used during logging. If no tag
       identifier is specified at export time, then the values in the "global"
       entry  are  used.  The "global" values can be modified by updating this
       entry in /etc/nfs/nfslog.conf.


       Each entry in the file must contain a mandatory tag identifier  and  at
       least  one  parameter/value  pair. If a parameter is not specified in a
       given entry, the global value of the parameter will be used. The  exact
       entry syntax follows:

         <tag>     [defaultdir=<path>] [log=<path><file>] \
         [fhtable=<path><file>] [buffer=<path><file>] [logformat=basic|extended]


       defaultdir=<path>

           Specifies  the  directory where the logging files and working files
           will be placed. This path is prepended to all relative paths speci‐
           fied in other parameters.


       log=<path><file>

           Specifies  the location of the user-readable log file. The log will
           be located in the defaultdir, unless <path> is an absolute path.


       fhtable=<path><file>

           Specifies the location of the private file handle to  path  mapping
           database files. These database files are for the private use of the
           NFS server kernel module and the nfslogd daemon. These  files  will
           be  located  in  the defaultdir, unless <path> is an absolute path.
           These database files are permanently stored  in  the  file  system.
           Consult nfslogd(8) for information on pruning the database files.


       buffer=<path><file>

           Specifies  the location of the private work buffer file used by the
           NFS server kernel module to record raw RPC information.  This  file
           is  later  processed  by the nfslog daemon, which in turn generates
           the user-readable log file. This work buffer file will  be  located
           in the defaultdir, unless <path> is an absolute path.


       logformat=basic|extended

           Sets  the  format  of the user-readable log file. If not specified,
           the basic format is used. The basic format is compatible  with  log
           files  generated  by  the  Washington University FTPd. The extended
           format provides a more detailed log, which includes directory modi‐
           fication  operations  not  included  in  the  basic format, such as
           mkdir, rmdir and remove. Note that the extended format is not  com‐
           patible with Washington University's FTPd log format.


EXAMPLES
       Example 1 Using the global Tag



       The "global" tag may be modified so that all exported file systems that
       enabled logging use a common set of parameters that conform to the spe‐
       cific  needs  of  the  user. These values are used until a specific tag
       identifier overrides them.


         global    defaultdir=/var/nfs log=logs/nfslog \
                   fhtable=tables/fhtable buffer=buffers/nfslog_workbuffer \
                   logformat=basic


       Example 2 Overriding the Global defaultdir and logformat



       Because log files can become very large, it may be desirable  to  store
       the logs and working files in separate file systems. This can be easily
       accomplished by simply specifying a different defaultdir for every file
       system exported by means of a unique tag:


         engineering    defaultdir=/engineering/logging \
                          logformat=extended
         accounting defaultdir=/accounting/logging
         marketing  defaultdir=/marketing/logging




       File  systems  shared  with  the engineering identifier will have their
       logs and workfiles located in /engineering/logging. For  instance,  the
       log file will be located at /engineering/logging/logs/nfslog. Note that
       the engineering log file will be stored in the extended  format,  while
       the rest of the log files will remain in the basic format.



       Any  of  the parameters can be updated in a tag identifier, which over‐
       rides the global settings.

ATTRIBUTES
       See attributes(7) for descriptions of the following attributes:


       tab() box; cw(2.75i) |cw(2.75i) lw(2.75i) |lw(2.75i) ATTRIBUTE  TYPEAT‐
       TRIBUTE VALUE _ Availabilityservice/file-system/nfs


SEE ALSO
       attributes(7), nfslogd(8), share_nfs(8)

NOTES
       Logs,  work  files, and file handle to path mapping database can become
       very large. Be aware of appropriate placement within  the  file  system
       name  space.  See  nfslogd(8))  for information on pruning the database
       files and cycling logs.



Oracle Solaris 11.4               2 Dec 2004                    nfslog.conf(5)
맨 페이지 내용의 저작권은 맨 페이지 작성자에게 있습니다.
RSS ATOM XHTML 5 CSS3