ost::Process(3) | Library Functions Manual | ost::Process(3) |
NAME¶
ost::Process - A class for containing portable process related functions that help create portable code.SYNOPSIS¶
#include <process.h>Public Types¶
typedef RETSIGTYPE(* Trap )(int)
Public Member Functions¶
bool lock (bool future=true)
Static Public Member Functions¶
static void detach (void)
Detailed Description¶
A class for containing portable process related functions that help create portable code. These are typically referenced thru Process::xxx static member functions. Many of these members are used both for win32 and posix systems although some may be platform specific. Peocess wrapper class. Author:David Sugar dyfet@ostel.com
Member Typedef Documentation¶
typedef RETSIGTYPE(* ost::Process::Trap)(int)¶
Member Function Documentation¶
static void ost::Process::attach (const char *devname) [static]¶
Attach the current process to another device or i/o session. It is deamonified and dissasociated with the prior parent process and controlling terminal. Parameters:devname path to attach to.
static bool ost::Process::cancel (intpid, intsig = 0) [static]¶
Cancel a running child process. Returns:0 on success.
Parameters:
pid process id.
sig cancel signal to apply.
static void ost::Process::detach (void) [static]¶
Detach current process into a daemon, posix only. Perhaps a similar method can be used for creating win32 'services'?static const char* ost::Process::getConfigDir (void) [static]¶
Get etc prefix path. Returns:etc prefix.
static const char* ost::Process::getEnv (const char *name) [static]¶
Get system environment. Returns:system environ symbol.
Parameters:
name of symbol.
static const char* ost::Process::getHomeDir (void) [static]¶
Get home directory. Returns:user home directory.
static size_t ost::Process::getPageSize (void) [static]¶
Return the effective operating system page size. Returns:system page size.
static const char* ost::Process::getUser (void) [static]¶
Get user name. Returns:user login id.
static bool ost::Process::isRealtime (void) [inline], [static]¶
Return true if realtime scheduling.static bool ost::Process::isScheduler (void) [static]¶
Return true if scheduler settable.static int ost::Process::join (intpid) [static]¶
Get the exit status of another process, waiting for it to exit. Returns:exit code from process.
Parameters:
pid process id.
bool ost::Process::lock (boolfuture = true)¶
Lock a process in memory. Ideally you should be deep enough where additional memallocs for functions will not kill you, or use false for future. Returns:true if successful.
Parameters:
future pages as well...
static void ost::Process::setEnv (const char *name, const char *value, booloverwrite) [static]¶
Set system environment in a standard manner. Parameters:name of environment symbol to set.
value of environment symbol.
overwrite true if replace existing symbol.
static bool ost::Process::setGroup (const char *id) [static]¶
Set the effective group id by name. Returns:true if successful.
static Trap ost::Process::setInterruptSignal (intsigno, Traphandler) [static]¶
Set system call interuptable signal handler. #return previous handler. Parameters:signo signal no.
handler trap handler.
static Trap ost::Process::setPosixSignal (intsigno, Traphandler) [static]¶
Set a posix compliant signal handler. Returns:previous handler.
Parameters:
signo signal no.
handler trap handler.
static void ost::Process::setPriority (intpri) [static]¶
Used to set process priority and optionally enable realtime.static void ost::Process::setRealtime (intpri = 0) [static]¶
Portable shortcut for setting realtime...static void ost::Process::setScheduler (const char *policy) [static]¶
Used to set process scheduling policy.static bool ost::Process::setUser (const char *id, boolgrp = true) [static]¶
Set user id by name. Returns:true if successful.
static int ost::Process::spawn (const char *exec, const char **argv, boolwait = true) [static]¶
Spawn a process and wait for it's exit code. In win32 this is done with the spawn system call. In posix, this is done with a fork, an execvp, and a waitpid. Warning:The implementation differences between posix and win32
systems may cause side effects. For instance, if you use atexit() and this
spawn method, on posix systems the function set up with atexit() will be
called when the parent process of the fork exits, which will not happen on
Win32 systems.
Returns:
error code from process.
Parameters:
exec name of executable.
argv list of command arguments.
wait for process to exit before return.
void ost::Process::unlock (void)¶
Unlock process pages.Author¶
Generated automatically by Doxygen for GNU CommonC++ from the source code.Sun Dec 29 2013 | GNU CommonC++ |