From 992f1e6b8f86b346fddd266b04d29cde69585633 Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Wed, 7 Apr 2004 10:15:11 +0000 Subject: Add all the source files from the old CVS tree, add the 5 missing chapters from the HOWTO and add jht's Samba by Example book. (This used to be commit 9fb5bcb93e57c5162b3ee6f9c7d777dc0269d100) --- docs/smbdotconf/logging/debughirestimestamp.xml | 18 ++++++++++++++++++ docs/smbdotconf/logging/debugpid.xml | 19 +++++++++++++++++++ docs/smbdotconf/logging/debugtimestamp.xml | 15 +++++++++++++++ docs/smbdotconf/logging/debuguid.xml | 17 +++++++++++++++++ docs/smbdotconf/logging/logfile.xml | 14 ++++++++++++++ docs/smbdotconf/logging/loglevel.xml | 20 ++++++++++++++++++++ docs/smbdotconf/logging/maxlogsize.xml | 16 ++++++++++++++++ docs/smbdotconf/logging/syslog.xml | 20 ++++++++++++++++++++ docs/smbdotconf/logging/syslogonly.xml | 12 ++++++++++++ 9 files changed, 151 insertions(+) create mode 100644 docs/smbdotconf/logging/debughirestimestamp.xml create mode 100644 docs/smbdotconf/logging/debugpid.xml create mode 100644 docs/smbdotconf/logging/debugtimestamp.xml create mode 100644 docs/smbdotconf/logging/debuguid.xml create mode 100644 docs/smbdotconf/logging/logfile.xml create mode 100644 docs/smbdotconf/logging/loglevel.xml create mode 100644 docs/smbdotconf/logging/maxlogsize.xml create mode 100644 docs/smbdotconf/logging/syslog.xml create mode 100644 docs/smbdotconf/logging/syslogonly.xml (limited to 'docs/smbdotconf/logging') diff --git a/docs/smbdotconf/logging/debughirestimestamp.xml b/docs/smbdotconf/logging/debughirestimestamp.xml new file mode 100644 index 0000000000..6be22a201a --- /dev/null +++ b/docs/smbdotconf/logging/debughirestimestamp.xml @@ -0,0 +1,18 @@ + + + Sometimes the timestamps in the log messages + are needed with a resolution of higher that seconds, this + boolean parameter adds microsecond resolution to the timestamp + message header when turned on. + + Note that the parameter + debug timestamp must be on for this to have an + effect. + + +no + diff --git a/docs/smbdotconf/logging/debugpid.xml b/docs/smbdotconf/logging/debugpid.xml new file mode 100644 index 0000000000..810aaa1260 --- /dev/null +++ b/docs/smbdotconf/logging/debugpid.xml @@ -0,0 +1,19 @@ + + + When using only one log file for more then one forked + smbd + 8-process there may be hard to + follow which process outputs which message. This boolean parameter + is adds the process-id to the timestamp message headers in the + logfile when turned on. + + Note that the parameter + debug timestamp must be on for this to have an + effect. + +no + diff --git a/docs/smbdotconf/logging/debugtimestamp.xml b/docs/smbdotconf/logging/debugtimestamp.xml new file mode 100644 index 0000000000..1c2f662573 --- /dev/null +++ b/docs/smbdotconf/logging/debugtimestamp.xml @@ -0,0 +1,15 @@ + + timestamp logs + + Samba debug log messages are timestamped + by default. If you are running at a high + debug level these timestamps + can be distracting. This boolean parameter allows timestamping + to be turned off. + +yes + diff --git a/docs/smbdotconf/logging/debuguid.xml b/docs/smbdotconf/logging/debuguid.xml new file mode 100644 index 0000000000..61155a4d70 --- /dev/null +++ b/docs/smbdotconf/logging/debuguid.xml @@ -0,0 +1,17 @@ + + + Samba is sometimes run as root and sometime + run as the connected user, this boolean parameter inserts the + current euid, egid, uid and gid to the timestamp message headers + in the log file if turned on. + + Note that the parameter + debug timestamp must be on for this to have an + effect. + +no + diff --git a/docs/smbdotconf/logging/logfile.xml b/docs/smbdotconf/logging/logfile.xml new file mode 100644 index 0000000000..46cd728039 --- /dev/null +++ b/docs/smbdotconf/logging/logfile.xml @@ -0,0 +1,14 @@ + + + This option allows you to override the name + of the Samba log file (also known as the debug file). + + This option takes the standard substitutions, allowing + you to have separate log files for each user or machine. + +/usr/local/samba/var/log.%m + diff --git a/docs/smbdotconf/logging/loglevel.xml b/docs/smbdotconf/logging/loglevel.xml new file mode 100644 index 0000000000..c023a71c73 --- /dev/null +++ b/docs/smbdotconf/logging/loglevel.xml @@ -0,0 +1,20 @@ + +debuglevel + + The value of the parameter (a astring) allows + the debug level (logging level) to be specified in the + smb.conf file. This parameter has been + extended since the 2.2.x series, now it allow to specify the debug + level for multiple debug classes. This is to give greater + flexibility in the configuration of the system. + + The default will be the log level specified on + the command line or level zero if none was specified. + + +3 passdb:5 auth:10 winbind:2 + diff --git a/docs/smbdotconf/logging/maxlogsize.xml b/docs/smbdotconf/logging/maxlogsize.xml new file mode 100644 index 0000000000..e496980fa0 --- /dev/null +++ b/docs/smbdotconf/logging/maxlogsize.xml @@ -0,0 +1,16 @@ + + + This option (an integer in kilobytes) specifies + the max size the log file should grow to. Samba periodically checks + the size and if it is exceeded it will rename the file, adding + a .old extension. + +A size of 0 means no limit. + +5000 +1000 + diff --git a/docs/smbdotconf/logging/syslog.xml b/docs/smbdotconf/logging/syslog.xml new file mode 100644 index 0000000000..5f67a02c0f --- /dev/null +++ b/docs/smbdotconf/logging/syslog.xml @@ -0,0 +1,20 @@ + + + This parameter maps how Samba debug messages + are logged onto the system syslog logging levels. Samba debug + level zero maps onto syslog LOG_ERR, debug + level one maps onto LOG_WARNING, debug level + two maps onto LOG_NOTICE, debug level three + maps onto LOG_INFO. All higher levels are mapped to + LOG_DEBUG. + + This parameter sets the threshold for sending messages + to syslog. Only messages with debug level less than this value + will be sent to syslog. + +1 + diff --git a/docs/smbdotconf/logging/syslogonly.xml b/docs/smbdotconf/logging/syslogonly.xml new file mode 100644 index 0000000000..0b255d4ca7 --- /dev/null +++ b/docs/smbdotconf/logging/syslogonly.xml @@ -0,0 +1,12 @@ + + + If this parameter is set then Samba debug + messages are logged into the system syslog only, and not to + the debug log files. + +no + -- cgit