From 0db324e2e5d9d3347ea0e93138372fb65aac09e6 Mon Sep 17 00:00:00 2001 From: Daniel Baumann Date: Mon, 15 Apr 2024 21:41:09 +0200 Subject: Merging upstream version 6.7. Signed-off-by: Daniel Baumann --- man3/getcwd.3 | 31 +++++++++++++++---------------- 1 file changed, 15 insertions(+), 16 deletions(-) (limited to 'man3/getcwd.3') diff --git a/man3/getcwd.3 b/man3/getcwd.3 index 7149581..1004458 100644 --- a/man3/getcwd.3 +++ b/man3/getcwd.3 @@ -10,7 +10,7 @@ .\" Modified Mon Dec 11 13:32:51 MET 2000 by aeb .\" Modified Thu Apr 22 03:49:15 CEST 2002 by Roger Luethi .\" -.TH getcwd 3 2023-07-20 "Linux man-pages 6.05.01" +.TH getcwd 3 2023-10-31 "Linux man-pages 6.7" .SH NAME getcwd, getwd, get_current_dir_name \- get current working directory .SH LIBRARY @@ -19,23 +19,23 @@ Standard C library .SH SYNOPSIS .nf .B #include -.PP +.P .BI "char *getcwd(char " buf [. size "], size_t " size ); .B "char *get_current_dir_name(void);" -.PP +.P .BI "[[deprecated]] char *getwd(char " buf [PATH_MAX]); .fi -.PP +.P .RS -4 Feature Test Macro Requirements for glibc (see .BR feature_test_macros (7)): .RE -.PP +.P .BR get_current_dir_name (): .nf _GNU_SOURCE .fi -.PP +.P .BR getwd (): .nf Since glibc 2.12: @@ -53,7 +53,7 @@ the calling process. The pathname is returned as the function result and via the argument .IR buf , if present. -.PP +.P The .BR getcwd () function copies an absolute pathname of the current working directory @@ -61,7 +61,7 @@ to the array pointed to by .IR buf , which is of length .IR size . -.PP +.P If the length of the absolute pathname of the current working directory, including the terminating null byte, exceeds .I size @@ -71,7 +71,7 @@ is set to .BR ERANGE ; an application should check for this error, and allocate a larger buffer if necessary. -.PP +.P As an extension to the POSIX.1-2001 standard, glibc's .BR getcwd () allocates the buffer dynamically using @@ -89,7 +89,7 @@ is allocated as big as necessary. The caller should .BR free (3) the returned buffer. -.PP +.P .BR get_current_dir_name () will .BR malloc (3) @@ -102,7 +102,7 @@ is set, and its value is correct, then that value will be returned. The caller should .BR free (3) the returned buffer. -.PP +.P .BR getwd () does not .BR malloc (3) @@ -136,7 +136,7 @@ and .BR getwd () this is the same value as .IR buf . -.PP +.P On failure, these functions return NULL, and .I errno is set to indicate the error. @@ -202,14 +202,13 @@ T{ .BR get_current_dir_name () T} Thread safety MT-Safe env .TE -.sp 1 .SH VERSIONS POSIX.1-2001 leaves the behavior of .BR getcwd () unspecified if .I buf is NULL. -.PP +.P POSIX.1-2001 does not define any errors for .BR getwd (). @@ -234,7 +233,7 @@ exceeds this limit, then the system call fails with the error .BR ENAMETOOLONG . In this case, the library functions fall back to a (slower) alternative implementation that returns the full pathname. -.PP +.P Following a change in Linux 2.6.36, .\" commit 8df9d1a4142311c084ffeeacb67cd34d190eff74 the pathname returned by the @@ -272,7 +271,7 @@ Removed in POSIX.1-2008. Use .BR getcwd () instead. -.PP +.P Under Linux, these functions make use of the .BR getcwd () system call (available since Linux 2.1.92). -- cgit v1.2.3