1
.\" Title: vfs_full_audit
2
.\" Author: [see the "AUTHOR" section]
3
.\" Generator: DocBook XSL Stylesheets v1.74.0 <http://docbook.sf.net/>
5
.\" Manual: System Administration tools
9
.TH "VFS_FULL_AUDIT" "8" "10/29/2009" "Samba 3\&.4" "System Administration tools"
10
.\" -----------------------------------------------------------------
11
.\" * (re)Define some macros
12
.\" -----------------------------------------------------------------
13
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
14
.\" toupper - uppercase a string (locale-aware)
15
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
17
.tr aAbBcCdDeEfFgGhHiIjJkKlLmMnNoOpPqQrRsStTuUvVwWxXyYzZ
19
.tr aabbccddeeffgghhiijjkkllmmnnooppqqrrssttuuvvwwxxyyzz
21
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
22
.\" SH-xref - format a cross-reference to an SH section
23
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
32
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
33
.\" SH - level-one heading that works better for non-TTY output
34
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
36
.\" put an extra blank line of space above the head in non-TTY output
43
.nr an-prevailing-indent \\n[IN]
47
.HTML-TAG ".NH \\n[an-level]"
49
.nr an-no-space-flag 1
51
\." make the size of the head bigger
56
.\" if n (TTY output), use uppercase
61
.\" if not n (not TTY), use normal case (not uppercase)
65
.\" if not n (not TTY), put a border/line under subheading
70
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
71
.\" SS - level-two heading that works better for non-TTY output
72
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
77
.nr an-prevailing-indent \\n[IN]
82
.nr an-no-space-flag 1
85
\." make the size of the head bigger
91
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
92
.\" BB/BE - put background/screen (filled box) around block of text
93
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
106
.if "\\$2"adjust-for-leading-newline" \{\
114
.nr BW \\n(.lu-\\n(.i
117
.ie "\\$2"adjust-for-leading-newline" \{\
118
\M[\\$1]\h'1n'\v'+.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
121
\M[\\$1]\h'1n'\v'-.5v'\D'P \\n(BWu 0 0 \\n(BHu -\\n(BWu 0 0 -\\n(BHu'\M[]
132
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
133
.\" BM/EM - put colored marker in margin next to block of text
134
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
151
\M[\\$1]\D'P -.75n 0 0 \\n(BHu -(\\n[.i]u - \\n(INu - .75n) 0 0 -\\n(BHu'\M[]
159
.\" -----------------------------------------------------------------
160
.\" * set default formatting
161
.\" -----------------------------------------------------------------
162
.\" disable hyphenation
164
.\" disable justification (adjust text to left margin only)
166
.\" -----------------------------------------------------------------
167
.\" * MAIN CONTENT STARTS HERE *
168
.\" -----------------------------------------------------------------
170
vfs_full_audit \- record Samba VFS operations in the system log
174
\FCvfs objects = full_audit\F[]
178
This VFS module is part of the
183
\FCvfs_full_audit\F[]
184
VFS module records selected client operations to the system log using
187
\FCvfs_full_audit\F[]
188
is able to record the complete set of Samba VFS operations:
403
sys_acl_delete_def_file
409
sys_acl_free_qualifier
430
sys_acl_get_qualifier
448
sys_acl_set_qualifier
472
In addition to these operations,
473
\FCvfs_full_audit\F[]
474
recognizes the special operation names "all" and "none ", which refer to all the VFS operations and none of the VFS operations respectively\&.
476
\FCvfs_full_audit\F[]
477
records operations in fixed format consisting of fields separated by \'|\' characters\&. The format is:
488
.BB lightgray adjust-for-leading-newline
491
smbd_audit: PREFIX|OPERATION|RESULT|FILE
493
.EB lightgray adjust-for-leading-newline
504
The record fields are:
515
\- the result of the full_audit:prefix string after variable substitutions
527
\- the name of the VFS operation
539
\- whether the operation succeeded or failed
551
\- the name of the file or directory the operation was performed on
555
This module is stackable\&.
558
vfs_full_audit:prefix = STRING
560
Prepend audit messages with STRING\&. STRING is processed for standard substitution variables listed in
561
\fBsmb.conf\fR(5)\&. The default prefix is "%u|%I"\&.
564
vfs_full_audit:success = LIST
566
LIST is a list of VFS operations that should be recorded if they succeed\&. Operations are specified using the names listed above\&.
569
vfs_full_audit:failure = LIST
571
LIST is a list of VFS operations that should be recorded if they failed\&. Operations are specified using the names listed above\&.
574
full_audit:facility = FACILITY
576
Log messages to the named
581
full_audit:priority = PRIORITY
583
Log messages with the named
589
Log file and directory open operations on the [records] share using the LOCAL7 facility and ALERT priority, including the username and IP address:
600
.BB lightgray adjust-for-leading-newline
604
\m[blue]\fBpath = /data/records\fR\m[]
605
\m[blue]\fBvfs objects = full_audit\fR\m[]
606
\m[blue]\fBfull_audit:prefix = %u|%I\fR\m[]
607
\m[blue]\fBfull_audit:success = open opendir\fR\m[]
608
\m[blue]\fBfull_audit:failure = all\fR\m[]
609
\m[blue]\fBfull_audit:facility = LOCAL7\fR\m[]
610
\m[blue]\fBfull_audit:priority = ALERT\fR\m[]
611
.EB lightgray adjust-for-leading-newline
623
This man page is correct for version 3\&.0\&.25 of the Samba suite\&.
626
The original Samba software and related utilities were created by Andrew Tridgell\&. Samba is now developed by the Samba Team as an Open Source project similar to the way the Linux kernel is developed\&.