aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorUlrich Drepper <drepper@redhat.com>2001-02-11 19:41:01 +0000
committerUlrich Drepper <drepper@redhat.com>2001-02-11 19:41:01 +0000
commitcb4fe8a2cd9f5ac089e967c9cbc92c693a2fa487 (patch)
tree21a6ad42b9a9e48de89a8aa1661f7ae251d799b1
parente4cf522929cc33ea951756509b0e4f166f0da59a (diff)
downloadglibc-cb4fe8a2cd9f5ac089e967c9cbc92c693a2fa487.zip
glibc-cb4fe8a2cd9f5ac089e967c9cbc92c693a2fa487.tar.gz
glibc-cb4fe8a2cd9f5ac089e967c9cbc92c693a2fa487.tar.bz2
(Working Directory): Make getwd as deprecated in the header.
-rw-r--r--manual/filesys.texi21
-rw-r--r--manual/resource.texi49
2 files changed, 66 insertions, 4 deletions
diff --git a/manual/filesys.texi b/manual/filesys.texi
index 84c9f6b..ccc8d55 100644
--- a/manual/filesys.texi
+++ b/manual/filesys.texi
@@ -115,7 +115,7 @@ software.
@comment unistd.h
@comment BSD
-@deftypefun {char *} getwd (char *@var{buffer})
+@deftypefn {Deprecated Function} {char *} getwd (char *@var{buffer})
This is similar to @code{getcwd}, but has no way to specify the size of
the buffer. The GNU library provides @code{getwd} only
for backwards compatibility with BSD.
@@ -125,6 +125,21 @@ The @var{buffer} argument should be a pointer to an array at least
system there is no limit to the size of a file name, so this is not
necessarily enough space to contain the directory name. That is why
this function is deprecated.
+@end deftypefn
+
+@comment unistd.h
+@comment GNU
+@deftypefun {char *} get_current_dir_name (void)
+@vindex PWD
+This @code{get_current_dir_name} function is bascially equivalent to
+@w{@code{getcwd (NULL, 0)}}. The only difference is that the value of
+the @code{PWD} variable is returned if this value is correct. This is a
+subtle difference which is visible if the path described by the
+@code{PWD} value is using one or more symbol links in which case the
+value returned by @code{getcwd} can resolve the symbol links and
+therefore yield a different result.
+
+This function is a GNU extension.
@end deftypefun
@comment unistd.h
@@ -279,8 +294,8 @@ This returns the @code{st_mode} value corresponding to @var{dtype}.
This structure may contain additional members in the future. Their
availability is always announced in the compilation environment by a
-macro names @code{_DIRENT_HAVE_D_xxx} where @code{xxx} is replaced by
-the name of the new member. For instance, the member @code{d_reclen}
+macro names @code{_DIRENT_HAVE_D_@var{xxx}} where @var{xxx} is replaced
+by the name of the new member. For instance, the member @code{d_reclen}
available on some systems is announced through the macro
@code{_DIRENT_HAVE_D_RECLEN}.
diff --git a/manual/resource.texi b/manual/resource.texi
index 9fc8b64..f9f2e7c 100644
--- a/manual/resource.texi
+++ b/manual/resource.texi
@@ -1353,7 +1353,8 @@ information about the physical memory the system has. The call
sysconf (_SC_PHYS_PAGES)
@end smallexample
-@noindent returns the total number of page of physical the system has.
+@noindent
+returns the total number of pages of physical the system has.
This does not mean all this memory is available. This information can
be found using
@@ -1371,6 +1372,31 @@ increases its memory usage). The value returned for
If all applications together constantly use more than that amount of
memory the system is in trouble.
+The GNU C library provides in addition to these already described way to
+get this information two functions. They are declared in the file
+@file{sys/sysinfo.h}. Programmers should prefer to use the
+@code{sysconf} method described above.
+
+@comment sys/sysinfo.h
+@comment GNU
+@deftypefun long int get_phys_pages (void)
+The @code{get_phys_pages} function returns the total number of pages of
+physical the system has. To get the amount of memory this number has to
+be multiplied by the page size.
+
+This function is a GNU extension.
+@end deftypefun
+
+@comment sys/sysinfo.h
+@comment GNU
+@deftypefun long int get_avphys_pages (void)
+The @code{get_phys_pages} function returns the number of available pages of
+physical the system has. To get the amount of memory this number has to
+be multiplied by the page size.
+
+This function is a GNU extension.
+@end deftypefun
+
@node Processor Resources
@section Learn about the processors available
@@ -1402,6 +1428,27 @@ processors and so the call
returns the number of processors which are currently inline (i.e.,
available).
+For these two pieces of information the GNU C library also provides
+functions to get the information directly. The functions are declared
+in @file{sys/sysinfo.h}.
+
+@comment sys/sysinfo.h
+@comment GNU
+@deftypefun int get_nprocs_conf (void)
+The @code{get_nprocs_conf} function returns the number of processors the
+operating system configured.
+
+This function is a GNU extension.
+@end deftypefun
+
+@comment sys/sysinfo.h
+@comment GNU
+@deftypefun int get_nprocs (void)
+The @code{get_nprocs} function returns the number of available processors.
+
+This function is a GNU extension.
+@end deftypefun
+
@cindex load average
Before starting more threads it should be checked whether the processors
are not already overused. Unix systems calculate something called the