Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
explain_futimens_or_die(3) Library Functions Manual explain_futimens_or_die(3)

NAME
       explain_futimens_or_die - change	file timestamps	and report errors

SYNOPSIS
       #include	<libexplain/futimens.h>
       void explain_futimens_or_die(int	fildes,	const struct time_spec *data);
       int   explain_futimens_on_error(int   fildes,  const  struct  time_spec
       *data);

DESCRIPTION
       The explain_futimens_or_die function is used to	call  the  futimens(3)
       system  call.  On failure an explanation	will be	printed	to stderr, ob-
       tained from the explain_futimens(3) function, and then the process ter-
       minates by calling exit(EXIT_FAILURE).

       The explain_futimens_on_error function is used to call the  futimens(3)
       system  call.  On failure an explanation	will be	printed	to stderr, ob-
       tained from the explain_futimens(3) function, but still returns to  the
       caller.

       fildes  The  fildes,  exactly as	to be passed to	the futimens(3)	system
	       call.

       data    The data, exactly as to be passed  to  the  futimens(3)	system
	       call.

RETURN VALUE
       The explain_futimens_or_die function only returns on success, see futi-
       mens(3) for more	information. On	failure, prints	an explanation and ex-
       its, it does not	return.

       The  explain_futimens_on_error function always returns the value	return
       by the wrapped futimens(3) system call.

EXAMPLE
       The explain_futimens_or_die function is intended	to be used in a	 fash-
       ion similar to the following example:
	      explain_futimens_or_die(fildes, data);

SEE ALSO
       futimens(3)
	       change file timestamps with nanosecond precision

       explain_futimens(3)
	       explain futimens(3) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2013 Peter	Miller

						    explain_futimens_or_die(3)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=explain_futimens_or_die&sektion=3&manpath=FreeBSD+Ports+15.0.quarterly>

home | help