1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
|
.\" (C) 2023, NGINX, Inc.
.\"
.TH nxt_unit_log 3 (date) "NGINX Unit (unreleased)"
.SH Name
nxt_unit_req_log,
nxt_unit_req_alert,
nxt_unit_req_error,
nxt_unit_req_warn,
nxt_unit_req_debug
\-
print messages to the debug log related to a request in a Unit app
.SH Library
NGINX Unit library
.RI ( libunit ", " -lunit )
.SH Synopsis
.nf
.B #include <nxt_unit.h>
.PP
.B [[gnu::format(printf, 3, 4)]]
.BI "void nxt_unit_req_log(nxt_unit_request_info_t *_Nullable " req ,
.BI " int " level ", const char *" fmt ", ...);"
.PP
.BI "#define nxt_unit_req_alert(" req ", " fmt ", ...) \fR/* ... */\fP"
.BI "#define nxt_unit_req_error(" req ", " fmt ", ...) \fR/* ... */\fP"
.BI "#define nxt_unit_req_warn(" req ", " fmt ", ...) \fR/* ... */\fP"
.BI "#define nxt_unit_req_debug(" req ", " fmt ", ...) \fR/* ... */\fP"
.fi
.SH Arguments
.TP
.I req
Request object.
.TP
.I level
Log level
.TP
.I fmt
See
.MR snprintf 3 .
.SH Description
.MR nxt_unit_req_log 3
is similar to
.MR nxt_unit_log 3 ,
but it associates the log to a specific request.
.SH Return value
None.
.SH Errors
If these functions fail to write to the Unit debug log,
they will fall back to standard error.
.SH Files
.TP
.I /usr/local/var/log/unit/unit.log
Unit debug log.
See
.MR unitd 8 .
.SH Examples
See
.MR nxt_unit_response_add_field 3 .
.SH Copyright
(C) 2017-2023, NGINX, Inc.
.PP
SPDX-License-Identifier: Apache-2.0
.SH See also
.MR nxt_unit_log 3 ,
.MR unitd 8 .
.PP
.UR https://unit.nginx.org
Website
.UE
.PP
.UR https://mailman.nginx.org/mailman/listinfo/unit
Mailing list
.UE
.PP
.UR https://github.com/nginx/unit
GitHub
.UE
|
