Skip to content

Commit 3e59b40

Browse files
committed
Document the effects of failure to execute the max_log_file_action helper
1 parent 6c1fc4d commit 3e59b40

2 files changed

Lines changed: 6 additions & 3 deletions

File tree

docs/auditd.conf.5

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -119,9 +119,9 @@ means that it will issue a warning to syslog.
119119
.IR exec
120120
/path-to-script will execute the script. You cannot pass parameters to the script. The script is also responsible for telling the auditd daemon to resume logging once its completed its action. This can be done by adding
121121
.I auditdctl --signal resume
122-
to the script. Also note that logging is stpped which this script runs. Whatever it does needs to be real quick because events are backing up in the kernel. The script
122+
to the script. Also note that logging is stopped when this script runs. Whatever it does needs to be real quick because events are backing up in the kernel. The script
123123
.B MUST
124-
delete or rename /var/log/audit/audit.log or when logging resumes, it will retrigger executing the script.
124+
delete or rename /var/log/audit/audit.log or when logging resumes, it will retrigger executing the script. If the script fails to execute, auditing is suspended until it is told to resume by sending it a signal.
125125
.IR suspend
126126
will cause the audit daemon to stop writing records to the disk. The daemon will still be alive. The
127127
.IR rotate
@@ -181,7 +181,7 @@ as well as sending the message to syslog.
181181
.I exec
182182
/path-to-script will execute the script. You cannot pass parameters to the script. The script is also responsible for telling the auditd daemon to resume logging once its completed its action. This can be done by adding service auditd resume to the script.
183183
.I suspend
184-
will cause the audit daemon to stop writing records to the disk. The daemon will still be alive. The
184+
will cause the audit daemon to stop writing records to the disk. If the script fails to execute, the audit daemon will be left suspended until its told to resume by sending it a signal. The
185185
.I single
186186
option will cause the audit daemon to put the computer system in single user mode. Except for rotate, it will perform this action just one time. The previously available
187187
.I halt

src/auditd-event.c

Lines changed: 3 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -807,6 +807,9 @@ static void check_log_file_size(void)
807807
logging_suspended = 1;
808808
exec_child_pid =
809809
safe_exec(config->max_log_file_exe);
810+
if (exec_child_pid < 1)
811+
audit_msg(LOG_ALERT,
812+
"Audit daemon failed to exec max_log_file_action helper - logging suspended");
810813
break;
811814
case SZ_SUSPEND:
812815
audit_msg(LOG_ERR,

0 commit comments

Comments
 (0)