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

FreeBSD Manual Pages

  
 
  

home | help
explain_settimeofday_or_dieLibrary Functions Manexplain_settimeofday_or_die(3)

NAME
       explain_settimeofday_or_die - sets system time and report errors

SYNOPSIS
       #include	<libexplain/settimeofday.h>
       void explain_settimeofday_or_die(const struct timeval *tv, const	struct
       timezone	*tz);
       int  explain_settimeofday_on_error(const	 struct	 timeval  *tv,	 const
       struct timezone *tz);

DESCRIPTION
       The explain_settimeofday_or_die function	is used	to call	the settimeof-
       day(2) system call. On  failure	an  explanation	 will  be  printed  to
       stderr,	obtained  from	the explain_settimeofday(3) function, and then
       the process terminates by calling exit(EXIT_FAILURE).

       The explain_settimeofday_on_error function is used to call the settime-
       ofday(2)	 system	 call.	On  failure  an	explanation will be printed to
       stderr, obtained	from the explain_settimeofday(3) function,  but	 still
       returns to the caller.

       tv      The  tv,	 exactly as to be passed to the	settimeofday(2)	system
	       call.

       tz      The tz, exactly as to be	passed to the  settimeofday(2)	system
	       call.

RETURN VALUE
       The  explain_settimeofday_or_die	 function only returns on success, see
       settimeofday(2) for more	information. On	failure, prints	an explanation
       and exits, it does not return.

       The explain_settimeofday_on_error function always returns the value re-
       turn by the wrapped settimeofday(2) system call.

EXAMPLE
       The explain_settimeofday_or_die function	is intended to be  used	 in  a
       fashion similar to the following	example:
	      explain_settimeofday_or_die(tv, tz);

SEE ALSO
       settimeofday(2)
	       sets system time

       explain_settimeofday(3)
	       explain settimeofday(2) errors

       exit(2) terminate the calling process

COPYRIGHT
       libexplain version 1.3
       Copyright (C) 2013 Peter	Miller

						explain_settimeofday_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_settimeofday_or_die&sektion=3&manpath=FreeBSD+12.2-RELEASE+and+Ports>

home | help