All of lore.kernel.org
 help / color / mirror / Atom feed
* Documenting MS_RELATIME
@ 2007-02-10 17:56 Michael Kerrisk
  2007-02-11  0:54 ` Dave Jones
  2007-02-12  6:53 ` Valerie Henson
  0 siblings, 2 replies; 10+ messages in thread
From: Michael Kerrisk @ 2007-02-10 17:56 UTC (permalink / raw)
  To: val_henson; +Cc: lkml

Val,

I'm just updating the mount(2) man page for MS_RELATIME, and this is the
text I've come up with:

       MS_RELATIME(Since Linux 2.6.20)
              When a file on this file system is accessed, only
              update  the  file's last accessed time (atime) if
              the current value of atime is less than or  equal
              to  the file's last modified (mtime) or last sta-
              tus change time (ctime).  This option  is  useful
              for  programs, such as mutt(1), that need to know
              when a file has been read since it was last modi-
              fied.

This text is based on your comments accompanying the various patches, but
it differs in a respect.  Your comments said that the atime would only be
updated if the atime is older than mtime/ctime.  However, what the code
actually does is update atime if it is is <= mtime/ctime -- i.e., atime is
older than or *or equal to* mtime/ctime.

I'm sure that the code implements your intention, but before incorporating
the above text I thought I just better check, since the code differs from
your comment.  Can you just confirm that the proposed man page text is okay.

Cheers,

Michael

-- 
Michael Kerrisk
maintainer of Linux man pages Sections 2, 3, 4, 5, and 7

Want to help with man page maintenance?  Grab the latest tarball at
http://www.kernel.org/pub/linux/docs/manpages/
read the HOWTOHELP file and grep the source files for 'FIXME'.

^ permalink raw reply	[flat|nested] 10+ messages in thread

end of thread, other threads:[~2007-02-12 20:26 UTC | newest]

Thread overview: 10+ messages (download: mbox.gz / follow: Atom feed)
-- links below jump to the message on this page --
2007-02-10 17:56 Documenting MS_RELATIME Michael Kerrisk
2007-02-11  0:54 ` Dave Jones
2007-02-12  6:55   ` Valerie Henson
2007-02-12 15:40     ` Dave Jones
2007-02-12 17:49       ` Jan Engelhardt
2007-02-12 17:55         ` Jörn Engel
2007-02-12 19:53         ` Petri Kaukasoina
2007-02-12 19:57           ` Valerie Henson
2007-02-12 19:42       ` Valerie Henson
2007-02-12  6:53 ` Valerie Henson

This is an external index of several public inboxes,
see mirroring instructions on how to clone and mirror
all data and code used by this external index.