gen/FreeBSD/ftok.3.patch

   1 --- ftok.3      2004-11-25 11:38:00.000000000 -0800
   2 +++ ftok.3.edit 2006-07-12 11:19:51.000000000 -0700
   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 @@ -42,10 +41,10 @@
  12  .Fn ftok
  13  function attempts to create a unique key suitable for use with the
  14  .Xr msgget 3 ,
  15 -.Xr semget 2
  16 +.Xr semget 2 ,
  17  and
  18  .Xr shmget 2
  19 -functions given the
  20 +functions, given the
  21  .Fa path
  22  of an existing file and a user-selectable
  23  .Fa id .
  24 @@ -63,10 +62,18 @@
  25  function will return -1 if
  26  .Fa path
  27  does not exist or if it cannot be accessed by the calling process.
  28 +.Sh LEGACY SYNOPSIS
  29 +.Fd #include <sys/types.h>
  30 +.Fd #include <sys/ipc.h>
  31 +.Pp
  32 +The include file
  33 +.In sys/types.h
  34 +is necessary.
  35  .Sh SEE ALSO
  36  .Xr semget 2 ,
  37  .Xr shmget 2 ,
  38 -.Xr msgget 3
  39 +.Xr msgget 3 ,
  40 +.Xr compat 5
  41  .Sh HISTORY
  42  The
  43  .Fn ftok
  44 @@ -75,9 +82,9 @@
  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.