E-MailRelay
|
A class for creating pid files. More...
#include <gpidfile.h>
Public Member Functions | |
PidFile (const Path &pid_file_path) | |
Constructor. More... | |
PidFile () | |
Default constructor. More... | |
void | init (const Path &pid_file_path) |
Used after default construction to make the object active. More... | |
~PidFile () | |
Destructor. Calls cleanup() to delete the file. More... | |
void | commit () |
Creates the file and installs signal handlers to cleanup() the file on abnormal process termination. More... | |
bool | committed () const |
Returns true if commit() has been called with a valid path(). More... | |
void | check () |
Throws an exception if the path is not absolute. More... | |
Path | path () const |
Returns the path as supplied to the constructor or init(). More... | |
PidFile (const PidFile &)=delete | |
PidFile (PidFile &&)=delete | |
void | operator= (const PidFile &)=delete |
void | operator= (PidFile &&)=delete |
Static Public Member Functions | |
static bool | cleanup (SignalSafe, const char *path) noexcept |
Deletes the specified pid file if it contains this process's id. More... | |
A class for creating pid files.
Works with G::Root and G::Daemon so that the pid file can get created very late in a daemon startup sequence. Installs a signal handler so that the pid file gets deleted on process termination.
Usage:
Definition at line 56 of file gpidfile.h.
|
explicit |
Constructor.
The path should normally be an absolute path. Use commit() to actually create the file.
Definition at line 49 of file gpidfile.cpp.
|
default |
Default constructor.
Constructs a do-nothing object. Initialise with init().
G::PidFile::~PidFile | ( | ) |
Destructor. Calls cleanup() to delete the file.
Definition at line 36 of file gpidfile.cpp.
void G::PidFile::check | ( | ) |
Throws an exception if the path is not absolute.
The use of G::Daemon normally requires an absolute path because it may change the current working directory.
Definition at line 126 of file gpidfile.cpp.
|
staticnoexcept |
Deletes the specified pid file if it contains this process's id.
Claims root privilege to read and delete the pid file (see G::Root::atExit()).
This is not normally needed by client code since it is installed as a signal handler (see G::Cleanup) and called from the destructor.
Signal-safe, reentrant implementation.
Definition at line 106 of file gpidfile.cpp.
void G::PidFile::commit | ( | ) |
Creates the file and installs signal handlers to cleanup() the file on abnormal process termination.
Does nothing if no pid file path has been defined. Throws on error.
The caller is responsible for setting the file ownership and permissions by switching effecive user-id and umask.
Definition at line 132 of file gpidfile.cpp.
bool G::PidFile::committed | ( | ) | const |
Returns true if commit() has been called with a valid path().
Definition at line 141 of file gpidfile.cpp.
void G::PidFile::init | ( | const Path & | pid_file_path | ) |
Used after default construction to make the object active.
Use commit() to actually create the file.
Definition at line 54 of file gpidfile.cpp.
G::Path G::PidFile::path | ( | ) | const |
Returns the path as supplied to the constructor or init().
Definition at line 146 of file gpidfile.cpp.