gen/FreeBSD/ftok.3.patch

   1 --- ftok.3.bsdnew       2009-11-08 14:20:21.000000000 -0800
   2 +++ ftok.3      2009-11-08 14:23:16.000000000 -0800
   3 @@ -33,7 +33,6 @@
   4  .Sh LIBRARY
   5  .Lb libc
   6  .Sh SYNOPSIS
   7 -.In sys/types.h
   8  .In sys/ipc.h
   9  .Ft key_t
  10  .Fn ftok "const char *path" "int id"
  11 @@ -41,11 +40,10 @@
  12  The
  13  .Fn ftok
  14  function attempts to create a unique key suitable for use with the
  15 -.Xr msgget 2 ,
  16 -.Xr semget 2
  17 +.Xr semget 2 ,
  18  and
  19  .Xr shmget 2
  20 -functions given the
  21 +functions, given the
  22  .Fa path
  23  of an existing file and a user-selectable
  24  .Fa id .
  25 @@ -63,10 +61,17 @@ The
  26  function will return -1 if
  27  .Fa path
  28  does not exist or if it cannot be accessed by the calling process.
  29 +.Sh LEGACY SYNOPSIS
  30 +.Fd #include <sys/types.h>
  31 +.Fd #include <sys/ipc.h>
  32 +.Pp
  33 +The include file
  34 +.In sys/types.h
  35 +is necessary.
  36  .Sh SEE ALSO
  37  .Xr semget 2 ,
  38  .Xr shmget 2 ,
  39 -.Xr msgget 2
  40 +.Xr compat 5
  41  .Sh HISTORY
  42  The
  43  .Fn ftok
  44 @@ -75,9 +80,9 @@ that use the System V IPC routines.
  45  .Sh AUTHORS
  46  .An Thorsten Lockert Aq tholo@sigmasoft.com
  47  .Sh BUGS
  48 -The returned key is computed based on the device minor number and inode of the
  49 -specified
  50 -.Fa path
  51 +The returned key is computed based on the device minor number and inode
  52 +of the specified
  53 +.Fa path ,
  54  in combination with the lower 8 bits of the given
  55  .Fa id .
  56 -Thus it is quite possible for the routine to return duplicate keys.
  57 +Thus, it is quite possible for the routine to return duplicate keys.