setutent()

Return to the beginning of the user-information file

Synopsis:

#include <utmp.h>

void setutent( void );

Library:

libc

Use the -l c option to qcc to link against this library. This library is usually included automatically.


Note: This function is in libc.a, but not in libc.so (in order to save space).

Description:

The setutent() function resets the input stream to the beginning of the file specified in _PATH_UTMP. Do this before each search for a new entry if you want the entire file to be examined.

Files:

_PATH_UTMP
Specifies the user information file.

Classification:

Unix

Safety:
Cancellation point Yes
Interrupt handler No
Signal handler Yes
Thread Yes

See also:

endutent(), getutent(), getutid(), getutline(), pututline(), utmp, utmpname()

login in the Utilities Reference