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.

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

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