utmpname()

Change the name of the user-information file

Synopsis:

#include <utmp.h>

void utmpname( char * __filename );

Arguments:

__filename
The new filename that you want to use.

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 utmpname() function lets you change the name of the file examined from the default file (_PATH_UTMP) to any other file. If the file doesn't exist, this won't be apparent until the first attempt to reference the file is made. This function doesn't open the file. It just closes the old file if it's currently open and saves the new file name.

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(), setutent(), utmp

login in the Utilities Reference