.\" Changed data type of proj_id; minor fixes
.\" aeb: further fixes; added notes.
.\"
-.TH FTOK 3 2015-03-02 "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
.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
.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
POSIX.1-2001, POSIX.1-2008.
.SH NOTES
On some ancient systems, the prototype was:
-.sp
-.RS
+.PP
+.in +4n
+.EX
.BI "key_t ftok(char *" pathname ", char " proj_id );
-.RE
+.EE
+.in
.PP
Today,
.I proj_id
that is why the behavior is said to be undefined when
.I proj_id
is zero.
-.LP
+.PP
Of course, no guarantee can be given that the resulting
.I key_t
is unique.
.BR semget (2),
.BR shmget (2),
.BR stat (2),
-.BR svipc (7)
+.BR sysvipc (7)