Libc-1244.1.7.tar.gz

[apple/libc.git] / gen / confstr.3

diff --git a/gen/confstr.3 b/gen/confstr.3
index b207ecfb9b5c6c5e3d84ac339f0e647a1ad4361d..224e7d18e132f3d8e1289dba0b236bd5d28b9194 100644 (file)
--- a/gen/confstr.3
+++ b/gen/confstr.3
@@ -85,6 +85,38 @@ The available values are as follows:
 .Pp
 .Bl -tag -width 6n
 .Pp
+.It Li _CS_DARWIN_USER_DIR
+Provides the path to a user's folder. The directory will be created if it
+does not already exist.
+.Pp
+This directory is created with access permissions of 0755 and restricted by
+the
+.Xr umask 2
+of the calling process and is not intended to be used for
+sensitive or temporary file storage, as all users can see files created here.
+If the user's umask allows it, files created here will be world readable,
+which could lead to information disclosure.
+.Pp
+.It Li _CS_DARWIN_USER_TEMP_DIR
+Provides the path to a user's temporary items directory. The directory will be
+created it if does not already exist. This directory is created with access
+permissions of 0700 and restricted by the
+.Xr umask 2
+of the calling process and is a good location for temporary files.
+.Pp
+By default, files in this location may be cleaned (removed) by the system if
+they are not accessed in 3 days.
+.Pp
+.It Li _CS_DARWIN_USER_CACHE_DIR
+Provides the path to the user's cache directory. The directory will be created
+if it does not already exist. This directory is created with access permissions
+of 0700 and restricted by the
+.Xr umask 2
+of the calling process and is a good location for user cache data as it will not
+be automatically cleaned by the system.
+.Pp
+Files in this location will be removed during safe boot.
+.Pp
 .It Li _CS_PATH
 Return a value for the
 .Ev PATH
@@ -123,6 +155,11 @@ In addition, the following errors may be reported:
 The value of the
 .Fa name
 argument is invalid.
+.It Bq Er ENOMEM
+Insufficient storage space is available.
+.It Bq Er EIO
+I/O error communicating with
+.Xr opendirectoryd 8 .
 .El
 .Sh LEGACY ERRORS
 If the call to