getauduser(3) [hpux man page]

getauduser(3)						     Library Functions Manual						     getauduser(3)

NAME

       getauduser - retrieve the accountable user for the current process

SYNOPSIS


DESCRIPTION

       retrieves the accountable user for the current process and saves the information into the buffer pointed to by user.  It also retrieves the
       time of authentication and saves it into the buffer pointed to by stime, if the information is available.  Caller must set usize and  tsize
       to  the	size  of the user and the stime buffers.  Note that the two buffers are always null terminated, even if it results in loss of some
       data.

       Programs using this routine must be compiled with

   Security Restrictions
       This call requires the user be superuser or possess privilege.  See privileges(5) for details.

RETURN VALUE

       returns the following values:

	       n     Successful completion.  n is the length of the retrieved login name, excluding the null byte.  If n is less than  usize,  the
		     login  name  is retrieved without truncation.  Otherwise, usize -1 bytes of login name are copied into user, and user is null
		     terminated.  The caller needs to retry with a larger buffer.

	      Failure.
		     is set to indicate the error.

ERRORS

       If fails, is set to one of the following values:

	      The caller is not a superuser or a privileged process.

	      The size of    stime buffer is smaller than See

	      Unrecognized

EXAMPLES

AUTHOR

       was developed by HP.

       The return values and null padding semantics for this system call are chosen such that a chance for buffer overflows in a C program is min-
       imized.	These semantics were inspired by of C99 and and as they appeared in OpenBSD.

SEE ALSO

       getaudid(2), setaudid(2), setauduser(3), audit(5), privileges(5).

																     getauduser(3)

settimeofday(2) 						System Calls Manual						   settimeofday(2)

NAME

       settimeofday - set the date and time

SYNOPSIS


DESCRIPTION

       The function sets the current time, expressed as seconds and microseconds since Epoch, and passed as the structure pointed to by tp.

       The resolution of the system clock is one microsecond.

   Security Restrictions
       Setting	the  time of day requires the privilege (SYSATTR).  Processes owned by the superuser will have this privilege.	Processes owned by
       other users may have this privilege, depending on system configuration.

       See privileges(5) for more information about privileged access on systems that support fine-grained privileges.

PARAMETERS

       tp   A pointer to a structure in which the current time is returned.

	    The structure includes the following members:

       tzp  If this parameter is not a null pointer, it is interpreted as a pointer to a structure under HP-UX.  The structure has  the  following
	    fields:

	    tz_minuteswest The number of minutes that the local time zone is west of Coordinated Universal Time (UTC) or Epoch.

	    tz_dsttime	   A  flag that, if nonzero, indicates that Daylight Savings Time (DST) applies locally during the appropriate part of the
			   year.

RETURN VALUE

       returns the following values under HP-UX:

	      Successful completion.

	      Failure.
		     is set to indicate the error.

ERRORS

       If fails, is set to the following value under HP-UX:

	      An argument address referenced invalid memory.

	      The	     member of the tp parameter to was less than zero or greater than 2^31.

	      A user lacking appropriate privileges attempted to
			     set the time.

WARNINGS

       Relying on a granularity of one microsecond may result in code that is not portable to other platforms.

AUTHOR

       was developed by the University of California, Berkeley, and HP.

SEE ALSO

       date(1), ftime(2), gettimeofday(2), stime(2), time(2), ctime(3C), privileges(5).

																   settimeofday(2)