pldd.1, bpf.2, chdir.2, clone.2, fanotify_init.2, fanotify_mark.2, intro.2, ipc.2...

[thirdparty/man-pages.git] / man3 / ftok.3

diff --git a/man3/ftok.3 b/man3/ftok.3
index 5a9838a9a963c3b8a288c4e05a03fe1f3f3ac15f..eb43247f0478276651dac962be9ed07cce41a774 100644 (file)
--- a/man3/ftok.3
+++ b/man3/ftok.3
@@ -1,6 +1,6 @@
 .\" Copyright 1993 Giorgio Ciucci (giorgio@crcc.it)
 .\"
-.\" %%%LICENSE_START(verbatim)
+.\" %%%LICENSE_START(VERBATIM)
 .\" Permission is granted to make and distribute verbatim copies of this
 .\" manual provided the copyright notice and this permission notice are
 .\" preserved on all copies.
@@ -26,7 +26,7 @@
 .\"    Changed data type of proj_id; minor fixes
 .\"    aeb: further fixes; added notes.
 .\"
-.TH FTOK 3 2001-11-28 "GNU" "Linux Programmer's Manual"
+.TH FTOK 3 2019-08-02 "GNU" "Linux Programmer's Manual"
 .SH NAME
 ftok \- convert a pathname and a project identifier to a System V IPC key
 .SH SYNOPSIS
@@ -34,7 +34,7 @@ ftok \- convert a pathname and a project identifier to a System V IPC key
 .B #include <sys/types.h>
 .B #include <sys/ipc.h>
 .fi
-.sp
+.PP
 .BI "key_t ftok(const char *" pathname ", int " proj_id );
 .SH DESCRIPTION
 The
@@ -51,7 +51,7 @@ type System V IPC key, suitable for use with
 .BR semget (2),
 or
 .BR shmget (2).
-.LP
+.PP
 The resulting value is the same for all pathnames that
 name the same file, when the same value of
 .I proj_id
@@ -67,16 +67,30 @@ On failure \-1 is returned, with
 indicating the error as for the
 .BR stat (2)
 system call.
+.SH ATTRIBUTES
+For an explanation of the terms used in this section, see
+.BR attributes (7).
+.TS
+allbox;
+lb lb lb
+l l l.
+Interface      Attribute       Value
+T{
+.BR ftok ()
+T}     Thread safety   MT-Safe
+.TE
 .SH CONFORMING TO
-POSIX.1-2001.
+POSIX.1-2001, POSIX.1-2008.
 .SH NOTES
-Under libc4 and libc5 (and under SunOS 4.x) the prototype was:
-.sp
-.RS
+On some ancient systems, the prototype was:
+.PP
+.in +4n
+.EX
 .BI "key_t ftok(char *" pathname ", char " proj_id );
-.RE
+.EE
+.in
 .PP
-Today
+Today,
 .I proj_id
 is an
 .IR int ,
@@ -86,11 +100,11 @@ Typical usage has an ASCII character
 that is why the behavior is said to be undefined when
 .I proj_id
 is zero.
-.LP
-Of course no guarantee can be given that the resulting
+.PP
+Of course, no guarantee can be given that the resulting
 .I key_t
 is unique.
-Typically, a best effort attempt combines the given
+Typically, a best-effort attempt combines the given
 .I proj_id
 byte, the lower 16 bits of the inode number, and the
 lower 8 bits of the device number into a 32-bit result.
@@ -103,4 +117,4 @@ and files on
 .BR semget (2),
 .BR shmget (2),
 .BR stat (2),
-.BR svipc (7)
+.BR sysvipc (7)