Re: [PATCH 1/7] manpage for fallocate

["Amit K. Arora" <aarora@linux.vnet.ibm.com>]

On Wed, Jul 11, 2007 at 12:37:01AM +0300, Heikki Orsila wrote:
> On Wed, Jul 11, 2007 at 01:48:20AM +0530, Amit K. Arora wrote:
> > .BI "int syscall(int, int fd, int mode, loff_t offset, loff_t len);
> 
> Correction: "int syscall(int fd, int mode, ...)",

Here, we have syscall() with first argument being the system call number
- so what you suggested is not correct.

But, yes, the synopsis should change at some time. Maybe to something
like:

	#include <fcntl.h>

	long fallocate(int fd, int mode, loff_t offset, loff_t len);

> > .TP
> > .B ENOSPC
> > There is not enough space left on the device containing the file
> > referred to by
> > .IR fd.
> > .TP
> > .B ESPIPE
> > .I fd
> > refers to a pipe of file descriptor.
> > .B ENOSYS
> > The filesystem underlying the file descriptor does not support this
> > operation.
> 
> EINTR?

Will add following errors:

  EINTR		A signal was caught during execution
  EIO		An I/O error occurred while reading from or writing to
		a file system.
  EOPNOTSUPP	The mode is not supported on the file descriptor.

and will update following :

  EINVAL	offset was less than 0, or len was less than or equal to 0.

--
Regards,
Amit Arora