sin/samba-mirror
1
0
Fork 0
mirror of https://github.com/samba-team/samba.git synced 2024-12-31 17:18:04 +03:00
Code

Added docs for new signal handling functions.

Browse Source 
Jeremy.
This commit is contained in:
Jeremy Allison 0001-01-01 00:00:00 +00:00
parent 6a3cb6f4b4
commit 24fb57e750
2 changed files with 26 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

11
docs/manpages/nmbd.8
View File

@ -216,6 +216,17 @@ See
.BR smb.conf (5) .BR smb.conf (5)
for more information. for more information.
.RE .RE
.SH SIGNALS
In version 1.9.18 and above, nmbd will accept SIGHUP, which will cause it to dump out
it's namelists into the file namelist.debug in the SAMBA/var/locks directory. This
will also cause nmbd to dump out it's server database in the log.nmb file.
Also new in version 1.9.18 and above is the ability to raise the debug log
level of nmbd by sending it a SIGUSR1 (kill -USR1 <nmbd-pid>) and to lower
the nmbd log level by sending it a SIGUSR2 (kill -USR2 <nmbd-pid>). This
is to allow transient problems to be diagnosed, whilst still running at
a normally low log level.
.SH VERSION .SH VERSION
This man page is (mostly) correct for version 1.9.16 of the Samba This man page is (mostly) correct for version 1.9.16 of the Samba

15
docs/manpages/smbd.8
View File

@ -414,6 +414,21 @@ creation of this man page the source code is still too fluid to warrant
describing each and every diagnostic. At this stage your best bet is still describing each and every diagnostic. At this stage your best bet is still
to grep the source code and inspect the conditions that gave rise to the to grep the source code and inspect the conditions that gave rise to the
diagnostics you are seeing. diagnostics you are seeing.
.SH SIGNALS
In version 1.9.18 and above the debug log level of smbd may be raised
by sending it a SIGUSR1 (kill -USR1 <smbd-pid>) and lowered by sending
it a SIGUSR2 (kill -USR2 <smbd-pid>). This is to allow transient problems
to be diagnosed, whilst still running at a normally low log level.
Note that as the signal handlers send a debug write, they are not
re-entrant in smbd. This you should wait until smbd is in a state of
waiting for an incoming smb before issuing them. It is possible to
make the signal handlers safe by un-blocking the signals before the
select call and re-blocking them after, however this would affect
performance.
.SH BUGS .SH BUGS
None known. None known.
.SH CREDITS .SH CREDITS