diff options
Diffstat (limited to 'doc/hurd.texi')
| -rw-r--r-- | doc/hurd.texi | 78 |
1 files changed, 38 insertions, 40 deletions
diff --git a/doc/hurd.texi b/doc/hurd.texi index 2d5ce5c5..ea73a4c6 100644 --- a/doc/hurd.texi +++ b/doc/hurd.texi @@ -97,10 +97,14 @@ * Hurd: (hurd). Using and programming the Hurd kernel servers. @end direntry -@ifinfo +@copying +This file documents the GNU Hurd kernel component. This edition of the +documentation was last updated for version @value{VERSION} of the Hurd. + Copyright @copyright{} 1994, 1996, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007 Free Software Foundation, Inc. +2004, 2005, 2007, 2008, 2009 Free Software Foundation, Inc. +@quotation 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. @@ -120,10 +124,12 @@ permission notice identical to this one. Permission is granted to copy and distribute translations of this manual into another language, under the above conditions for modified versions. -@end ifinfo +@end quotation +@end copying @setchapternewpage none @settitle Hurd Reference Manual + @titlepage @finalout @title The GNU Hurd Reference Manual @@ -132,29 +138,15 @@ into another language, under the above conditions for modified versions. @page @vskip 0pt plus 1filll -Copyright @copyright{} 1994, 1996, 1998, 1999, 2000, 2001, 2002, 2003, -2004, 2005, 2007 Free Software Foundation, Inc. - -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. - -Permission is granted to copy and distribute modified versions of this -manual under the conditions for verbatim copying, provided also that -the entire resulting derived work is distributed under the terms of a -permission notice identical to this one. - -Permission is granted to copy and distribute translations of this manual -into another language, under the above conditions for modified versions. +@insertcopying @end titlepage -@ifinfo - +@ifnottex @node Top @top The GNU Hurd -This file documents the GNU Hurd kernel component. This edition of the -documentation was last updated for version @value{VERSION} of the Hurd. +@insertcopying +@end ifnottex @menu * Introduction:: How to use this manual. @@ -336,8 +328,6 @@ Auth Interface @end detailmenu @end menu -@end ifinfo - @node Introduction @chapter Introduction @@ -1769,7 +1759,7 @@ new reference port. (FIXME: xref the C library manual for information on how to send sig_post messages.) The server then sends one @code{SIGIO} signal to each registered async -user everytime I/O becomes possible. I/O is possible if at least one +user every time I/O becomes possible. I/O is possible if at least one byte can be read or written immediately. The definition of ``immediately'' must be the same as for the implementation of the @code{O_NONBLOCK} flag (@pxref{Open Modes}). In addition, every time a @@ -1816,27 +1806,23 @@ this by calling @code{io_get_icky_async_id}. Users may call @code{io_stat} to find out information about the I/O object. Most of the fields of a @code{struct stat} are meaningful only for files. All objects, however, must support the fields -@var{st_fstype}, @var{st_fsid}, @var{st_ino}, @var{st_atime}, -@var{st_atime_usec}, @var{st_mtime_user}, @var{st_ctime}, -@var{st_ctime_usec}, and @var{st_blksize}. +@var{st_fstype}, @var{st_fsid}, @var{st_ino}, @var{st_atim}, +@var{st_mtim}, @var{st_ctim}, and @var{st_blksize}. @var{st_fstype}, @var{st_fsid}, and @var{st_ino} must be unique for the underlying object across the entire system. -@var{st_atime} and @var{st_atime_usec} hold the seconds and -microseconds, respectively, of the system clock at the last time the +@var{st_atim} holds the timestamp of the system clock at the last time the object was read with @code{io_read}. -@var{st_mtime} and @var{st_mtime_usec} hold the seconds and microseconds, -respectively, of the system clock at the last time the object was -written with @code{io_write}. +@var{st_mtim} holds the timestamp of the system clock at the last time the +object was written with @code{io_write}. -Other appropriate operations may update the @var{atime} and the -@var{mtime} as well; both the file and socket interfaces specify such +Other appropriate operations may update the @var{atim} and the +@var{mtim} as well; both the file and socket interfaces specify such operations. -@var{st_ctime} and @var{st_ctime_usec} hold the seconds and -microseconds, respectively, of the system clock at the last time +@var{st_ctim} holds the timestamp of the system clock at the last time permanent meta-data associated with the object was changed. The exact operations which cause such an update are server-dependent, but must include the creation of the object. @@ -2144,6 +2130,13 @@ some common ones are: If no options are supplied, @var{filesys}' current options are printed. +The options passed as @var{fs_option}s are meant to augment or change those +which are already set, they're not meant to completely replace the existing +command line options. For example, passing @code{--readonly} to a file system +server will change the server from writable to read-only, but will not touch +the used backing store. Passing @code{--address=new_IP} to +@file{/servers/socket/2} will change the local IP address to @var{new_IP}, but +will not touch the interface, netmask and gateway settings. @node Trivfs Library @section Trivfs Library @@ -3928,10 +3921,15 @@ locked since). @var{dir} must always be provided as at least a hint for disk allocation strategies. @end deftypefun +@deftypefun void diskfs_set_node_atime (@w{struct node *@var{np}}) +If disk is not readonly and the noatime option is not enabled, set +@code{@var{np}->dn_set_atime}. +@end deftypefun + @deftypefun void diskfs_set_node_times (@w{struct node *@var{np}}) If @code{@var{np}->dn_set_ctime} is set, then modify -@code{@var{np}->dn_stat.st_ctime} appropriately; do the analogous -operations for atime and mtime as well. +@code{@var{np}->dn_stat.st_ctim} appropriately; do the analogous +operations for @code{st_atim} and @code{st_mtim} as well. @end deftypefun @deftypefun {struct node *} diskfs_check_lookup_cache (@w{struct node *@var{dir}}, @w{char *@var{name}}) @@ -4016,8 +4014,8 @@ Set @code{*@var{statfsbuf}} with appropriate values to reflect the current state of the filesystem. @end deftypefun -@deftypefun error_t diskfs_lookup (@w{struct node *@var{dp}}, @w{char *@var{name}}, @w{enum lookup_type @var{type}}, @w{struct node **@var{np}}, @w{struct dirstat *@var{ds}}, @w{struct protid *@var{cred}}) -@deftypefunx error_t diskfs_lookup_hard (@w{struct node *@var{dp}}, @w{char *@var{name}}, @w{enum lookup_type @var{type}}, @w{struct node **@var{np}}, @w{struct dirstat *@var{ds}}, @w{struct protid *@var{cred}}) +@deftypefun error_t diskfs_lookup (@w{struct node *@var{dp}}, @w{const char *@var{name}}, @w{enum lookup_type @var{type}}, @w{struct node **@var{np}}, @w{struct dirstat *@var{ds}}, @w{struct protid *@var{cred}}) +@deftypefunx error_t diskfs_lookup_hard (@w{struct node *@var{dp}}, @w{const char *@var{name}}, @w{enum lookup_type @var{type}}, @w{struct node **@var{np}}, @w{struct dirstat *@var{ds}}, @w{struct protid *@var{cred}}) You should not define @code{diskfs_lookup}, because it is simply a wrapper for @code{diskfs_lookup_hard}, and is already defined in @code{libdiskfs}. |