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 the file handle to path mapping database can  be‐
       come very large. Be aware of appropriate placement within the file sys‐
       tem  name space. See nfslogd(8) for information on pruning the database
       files and cycling logs.

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