auth_child.h File Reference

#include <X11/X.h>

Go to the source code of this file.

Functions
void	KillAuthChildSigHandler (int signo)
	Kill the auth child. More...
int	WantAuthChild (int force_auth)
	Checks whether an auth child should be running. More...
int	WatchAuthChild (Window w, const char *executable, int force_auth, const char *stdinbuf, int *auth_running)
	Starts or stops the authentication child process. More...

Function Documentation

KillAuthChildSigHandler()

void KillAuthChildSigHandler

(

int

signo

)

Kill the auth child.

This can be used from a signal handler.

WantAuthChild()

int WantAuthChild

(

int

force_auth

)

Checks whether an auth child should be running.

Parameters

force_auth

If true, assume we want to start a new auth child.

Returns

true if an auth child is expected to be running after a call to WatchAuthChild() with this force_auth parameter.

WatchAuthChild()

int WatchAuthChild	(	Window	w,
		const char *	executable,
		int	force_auth,
		const char *	stdinbuf,
		int *	auth_running
	)

Starts or stops the authentication child process.

Parameters

w	The screen saver window. Will get cleared after auth child execution.
executable	What binary to spawn for authentication. No arguments will be passed.
force_auth	If true, the auth child will be spawned if not already running.
stdinbuf	If non-NULL, this data will be sent to stdin of the auth child.
auth_running	Will be set to the status of the current auth child (i.e. true iff it is running).

Returns

true if authentication was successful, i.e. if the auth child exited with status zero.