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)

NAME | SYNOPSIS | DESCRIPTION | RETURN VALUE | EXAMPLE | SEE ALSO | COPYRIGHT

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

home | help