diff options
author | rwatson <rwatson@FreeBSD.org> | 2005-04-16 12:12:27 +0000 |
---|---|---|
committer | rwatson <rwatson@FreeBSD.org> | 2005-04-16 12:12:27 +0000 |
commit | 04a7b2d37985e5ded07762fa186128aa3185b37c (patch) | |
tree | 790777ea9dc25e1ddaab554028cd53d3ea71c063 /share/man/man9/alq.9 | |
parent | a5028ef44ecc830d8e8984fab2ad3c77c66a0092 (diff) | |
download | FreeBSD-src-04a7b2d37985e5ded07762fa186128aa3185b37c.zip FreeBSD-src-04a7b2d37985e5ded07762fa186128aa3185b37c.tar.gz |
Modify the alq(9) alq_open() API to accept a file creation mode, rather
than defaulting the cmode argument to vn_open() to 0. Supply a default
argument of ALQ_DEFAULT_CMODE (0600) in current callers.
Discussed with/pointed out by: hmp
Reveiwed by: jeff, hmp
MFC after: 3 days
Diffstat (limited to 'share/man/man9/alq.9')
-rw-r--r-- | share/man/man9/alq.9 | 17 |
1 files changed, 15 insertions, 2 deletions
diff --git a/share/man/man9/alq.9 b/share/man/man9/alq.9 index fc2b618..ec6ef26 100644 --- a/share/man/man9/alq.9 +++ b/share/man/man9/alq.9 @@ -44,6 +44,7 @@ .Fa "struct alq **app" .Fa "const char *file" .Fa "struct ucred *cred" +.Fa "int cmode" .Fa "int size" .Fa "int count" .Fc @@ -98,10 +99,22 @@ The function creates a new logging queue. The .Fa file -argument is the name of the file to open for logging. +argument is the name of the file to open for logging; if the file does not +yet exist, +.Fn alq_open +will attempt to create it. +The +.Fa cmode +argument will be passed to +.Fn vn_open +as the requested creation mode, to be used if the file will be created by +.Fn alq_open . +Consumers of this API may wish to pass +.Dv ALQ_DEFAULT_CMODE , +a default creation mode suitable for most applications. The argument .Fa cred -specifies the credentials to use when opening the file. +specifies the credentials to use when opening and performing I/O on the file. The size of each entry in the queue is determined by .Fa size . The |