aboutsummaryrefslogtreecommitdiffstats
path: root/man/man3
diff options
context:
space:
mode:
Diffstat (limited to 'man/man3')
-rw-r--r--man/man3/dbopen.38
-rw-r--r--man/man3/dlopen.322
-rw-r--r--man/man3/futimes.34
-rw-r--r--man/man3/getmntent.34
-rw-r--r--man/man3/getutent.36
-rw-r--r--man/man3/updwtmp.34
6 files changed, 24 insertions, 24 deletions
diff --git a/man/man3/dbopen.3 b/man/man3/dbopen.3
index 802f43e6f3..0ec15e3bb7 100644
--- a/man/man3/dbopen.3
+++ b/man/man3/dbopen.3
@@ -17,7 +17,7 @@ Standard C library
.B #include <db.h>
.B #include <fcntl.h>
.P
-.BI "DB *dbopen(const char *" file ", int " flags ", int " mode \
+.BI "DB *dbopen(const char *" path ", int " flags ", int " mode \
", DBTYPE " type ,
.BI " const void *" openinfo );
.fi
@@ -45,11 +45,11 @@ and
.P
.BR dbopen ()
opens
-.I file
+.I path
for reading and/or writing.
Files never intended to be preserved on disk may be created by setting
the
-.I file
+.I path
argument to NULL.
.P
The
@@ -193,7 +193,7 @@ A file descriptor referencing the same file will be returned to all
processes which call
.BR dbopen ()
with the same
-.I file
+.I path
name.
This file descriptor may be safely used as an argument to the
.BR fcntl (2)
diff --git a/man/man3/dlopen.3 b/man/man3/dlopen.3
index 042525a254..9b40ac5133 100644
--- a/man/man3/dlopen.3
+++ b/man/man3/dlopen.3
@@ -14,14 +14,14 @@ Dynamic linking library
.nf
.B #include <dlfcn.h>
.P
-.BI "void *dlopen(const char *" filename ", int " flags );
+.BI "void *dlopen(const char *" path ", int " flags );
.BI "int dlclose(void *" handle );
.P
.B #define _GNU_SOURCE
.br
.B #include <dlfcn.h>
.P
-.BI "void *dlmopen(Lmid_t " lmid ", const char *" filename ", int " flags );
+.BI "void *dlmopen(Lmid_t " lmid ", const char *" path ", int " flags );
.fi
.SH DESCRIPTION
.SS dlopen()
@@ -30,7 +30,7 @@ The function
loads the dynamic shared object (shared library)
file named by the null-terminated
string
-.I filename
+.I path
and returns an opaque "handle" for the loaded object.
This handle is employed with other functions in the dlopen API, such as
.BR dlsym (3),
@@ -40,17 +40,17 @@ and
.BR dlclose ().
.P
If
-.I filename
+.I path
.\" FIXME On Solaris, when handle is NULL, we seem to get back
.\" a handle for (something like) the root of the namespace.
.\" The point here is that if we do a dlmopen(LM_ID_NEWLM), then
-.\" the filename==NULL case returns a different handle than
+.\" the path==NULL case returns a different handle than
.\" in the initial namespace. But, on glibc, the same handle is
.\" returned. This is probably a bug in glibc.
.\"
is NULL, then the returned handle is for the main program.
If
-.I filename
+.I path
contains a slash ("/"), then it is interpreted as a (relative
or absolute) pathname.
Otherwise, the dynamic linker searches for the object as follows
@@ -81,7 +81,7 @@ The cache file
(maintained by
.BR ldconfig (8))
is checked to see whether it contains an entry for
-.IR filename .
+.IR path .
.IP \[bu]
The directories
.I /lib
@@ -90,7 +90,7 @@ and
are searched (in that order).
.P
If the object specified by
-.I filename
+.I path
has dependencies on other shared objects,
then these are also automatically loaded by the dynamic linker
using the same rules.
@@ -167,7 +167,7 @@ its own symbols in preference to global symbols with the same name
contained in objects that have already been loaded.
.P
If
-.I filename
+.I path
is NULL, then the returned handle is for the main program.
When given to
.BR dlsym (3),
@@ -235,7 +235,7 @@ fails for any reason, it returns NULL.
.SS dlmopen()
This function performs the same task as
.BR dlopen ()\[em]the
-.I filename
+.I path
and
.I flags
arguments, as well as the return value, are the same,
@@ -280,7 +280,7 @@ to reference all of the other shared objects that it requires,
since the new namespace is initially empty.
.P
If
-.I filename
+.I path
is NULL, then the only permitted value for
.I lmid
is
diff --git a/man/man3/futimes.3 b/man/man3/futimes.3
index e342edae3e..d8505303a5 100644
--- a/man/man3/futimes.3
+++ b/man/man3/futimes.3
@@ -14,7 +14,7 @@ Standard C library
.B #include <sys/time.h>
.P
.BI "int futimes(int " fd ", const struct timeval " tv [2]);
-.BI "int lutimes(const char *" filename ", const struct timeval " tv [2]);
+.BI "int lutimes(const char *" path ", const struct timeval " tv [2]);
.fi
.P
.RS -4
@@ -43,7 +43,7 @@ rather than via a pathname.
changes the access and modification times of a file in the same way as
.BR utimes (2),
with the difference that if
-.I filename
+.I path
refers to a symbolic link, then the link is not dereferenced:
instead, the timestamps of the symbolic link are changed.
.SH RETURN VALUE
diff --git a/man/man3/getmntent.3 b/man/man3/getmntent.3
index fecc3f99e2..48abdac4a3 100644
--- a/man/man3/getmntent.3
+++ b/man/man3/getmntent.3
@@ -15,7 +15,7 @@ Standard C library
.B #include <stdio.h>
.B #include <mntent.h>
.P
-.BI "FILE *setmntent(const char *" filename ", const char *" type );
+.BI "FILE *setmntent(const char *" path ", const char *" type );
.P
.BI "struct mntent *getmntent(FILE *" stream );
.P
@@ -56,7 +56,7 @@ and the mounted filesystem description file
The
.BR setmntent ()
function opens the filesystem description file
-.I filename
+.I path
and returns a file pointer which can be used by
.BR getmntent ().
The argument
diff --git a/man/man3/getutent.3 b/man/man3/getutent.3
index 6bb4d37540..c9f7c48970 100644
--- a/man/man3/getutent.3
+++ b/man/man3/getutent.3
@@ -23,18 +23,18 @@ Standard C library
.B void setutent(void);
.B void endutent(void);
.P
-.BI "int utmpname(const char *" file );
+.BI "int utmpname(const char *" path );
.fi
.SH DESCRIPTION
New applications should use the POSIX.1-specified "utmpx" versions of
these functions; see STANDARDS.
.P
.BR utmpname ()
-sets the name of the utmp-format file for the other utmp
+sets the pathname of the utmp-format file for the other utmp
functions to access.
If
.BR utmpname ()
-is not used to set the filename
+is not used to set the pathname
before the other functions are used, they assume
.BR _PATH_UTMP ,
as defined in
diff --git a/man/man3/updwtmp.3 b/man/man3/updwtmp.3
index 38099ba1fe..08ad76f0be 100644
--- a/man/man3/updwtmp.3
+++ b/man/man3/updwtmp.3
@@ -13,7 +13,7 @@ System utilities library
.nf
.B #include <utmp.h>
.P
-.BI "void updwtmp(const char *" wtmp_file ", const struct utmp *" ut );
+.BI "void updwtmp(const char *" wtmp_path ", const struct utmp *" ut );
.BI "void logwtmp(const char *" line ", const char *" name \
", const char *" host );
.fi
@@ -58,7 +58,7 @@ glibc provides (since glibc 2.1):
.EX
.BR "#define _GNU_SOURCE " "/* See feature_test_macros(7) */"
.B #include <utmpx.h>
-.BI "void updwtmpx (const char *" wtmpx_file ", const struct utmpx *" utx );
+.BI "void updwtmpx (const char *" wtmpx_path ", const struct utmpx *" utx );
.EE
.in
.P