rpm  4.5
Data Structures | Typedefs | Functions | Variables
rpmsq.h File Reference
#include <rpmsw.h>
Include dependency graph for rpmsq.h:
This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  rpmsqElem
 SIGCHLD queue element. More...
 

Typedefs

typedef struct rpmsig_srpmsig
 
typedef struct rpmsqElemrpmsq
 
typedef void(* rpmsqAction_t )(int signum, void *info, void *context)
 Default signal handler prototype.
 

Functions

int rpmsqInsert (void *elem, void *prev)
 Insert node into from queue.
 
int rpmsqRemove (void *elem)
 Remove node from queue.
 
void rpmsqAction (int signum, void *info, void *context)
 Default signal handler.
 
int rpmsqEnable (int signum, rpmsqAction_t handler)
 Enable or disable a signal handler.
 
pid_t rpmsqFork (rpmsq sq)
 Fork a child process.
 
pid_t rpmsqWait (rpmsq sq)
 Wait for child process to be reaped.
 
void * rpmsqThread (void *(*start)(void *arg), void *arg)
 Call a function in a thread.
 
int rpmsqJoin (void *thread)
 Wait for thread to terminate.
 
int rpmsqThreadEqual (void *thread)
 Compare thread with current thread.
 
int rpmsqExecve (const char **argv)
 Execute a command, returning its status.
 

Variables

int _rpmsq_debug
 
rpmsq rpmsqQueue
 
sigset_t rpmsqCaught
 

Typedef Documentation

typedef struct rpmsig_s* rpmsig

Definition at line 13 of file rpmsq.h.

typedef struct rpmsqElem* rpmsq

Definition at line 17 of file rpmsq.h.

typedef void(* rpmsqAction_t)(int signum, void *info, void *context)

Default signal handler prototype.

Parameters
signumsignal number
info(siginfo_t) signal info
contextsignal context

Definition at line 25 of file rpmsq.h.

Function Documentation

void rpmsqAction ( int  signum,
void *  info,
void *  context 
)

Default signal handler.

Parameters
signumsignal number
info(siginfo_t) signal info
contextsignal context

Definition at line 286 of file rpmsq.c.

References rpmsqElem::child, errno, rpmsqElem::pipes, rpmsqElem::q_forw, rpmsqElem::reaped, rpmsigTbl, save, rpmsig_s::signum, and rpmsqElem::status.

Referenced by rpmsqEnable().

int rpmsqEnable ( int  signum,
rpmsqAction_t  handler 
)

Enable or disable a signal handler.

Parameters
signumsignal to enable (or disable if negative)
handlersa_sigaction handler (or NULL to use rpmsqHandler())
Returns
no. of refs, -1 on error

Definition at line 335 of file rpmsq.c.

References ADD_REF, DO_LOCK, DO_UNLOCK, rpmsqElem::id, ME, rpmsigTbl, rpmsqAction(), rpmsig_s::signum, and SUB_REF.

Referenced by rpmdbClose(), rpmdbOpenDatabase(), rpmsqExecve(), rpmsqFork(), rpmsqWaitUnregister(), and sigchld_cancel().

int rpmsqExecve ( const char **  argv)

Execute a command, returning its status.

Definition at line 609 of file rpmsq.c.

References ADD_REF, alloca(), CLEANUP_HANDLER, CLEANUP_RESET, DO_LOCK, DO_UNLOCK, errno, INIT_LOCK, rpmsigTbl_sigchld, rpmsigTbl_sigint, rpmsigTbl_sigquit, rpmsqEnable(), sigchld_cancel(), and SUB_REF.

pid_t rpmsqFork ( rpmsq  sq)

Fork a child process.

Parameters
sqscriptlet queue element
Returns
fork(2) pid

Definition at line 390 of file rpmsq.c.

References rpmsqElem::child, ME, rpmsqElem::pipes, rpmsqElem::reaper, rpmsqEnable(), and rpmsqInsert().

Referenced by runScript().

int rpmsqInsert ( void *  elem,
void *  prev 
)

Insert node into from queue.

Parameters
elemnode to link
prevprevious node from queue
Returns
0 on success

Definition at line 199 of file rpmsq.c.

References rpmsqElem::child, rpmsqElem::id, ME, rpmsqElem::pipes, rpmsqElem::reaped, rpmsqElem::reaper, and rpmsqElem::status.

Referenced by rpmsqFork().

int rpmsqJoin ( void *  thread)

Wait for thread to terminate.

Parameters
threadthread
Returns
0 on success

Definition at line 565 of file rpmsq.c.

Referenced by fsmNext(), and rpmpsmNext().

int rpmsqRemove ( void *  elem)

Remove node from queue.

Parameters
elemnode to link
Returns
0 on success

Definition at line 228 of file rpmsq.c.

References rpmsqElem::child, rpmsqElem::id, ME, rpmsqElem::pipes, rpmsqElem::reaped, and rpmsqElem::status.

Referenced by rpmsqWaitUnregister().

void* rpmsqThread ( void *(*)(void *arg)  start,
void *  arg 
)

Call a function in a thread.

Parameters
startfunction
argfunction argument
Returns
thread pointer (NULL on error)

Definition at line 556 of file rpmsq.c.

Referenced by fsmNext(), and rpmpsmNext().

int rpmsqThreadEqual ( void *  thread)

Compare thread with current thread.

Parameters
threadthread
Returns
0 if not equal

Definition at line 573 of file rpmsq.c.

pid_t rpmsqWait ( rpmsq  sq)

Wait for child process to be reaped.

Parameters
sqscriptlet queue element
Returns
reaped child pid

Definition at line 524 of file rpmsq.c.

References rpmsqElem::child, ME, rpmsqElem::reaped, rpmsqElem::reaper, rpmsqWaitUnregister(), and rpmsqElem::status.

Referenced by psmWait().

Variable Documentation

int _rpmsq_debug

Definition at line 189 of file rpmsq.c.

sigset_t rpmsqCaught

Definition at line 260 of file rpmsq.c.

rpmsq rpmsqQueue

Definition at line 196 of file rpmsq.c.