pinktrace-0.0.5: Haskell bindings to Pink's Tracing LibraryContentsIndex
System.PinkTrace.Event
Portabilitynon-portable, requires linux
Stabilityprovisional
Maintaineralip@exherbo.org
Description
Pink's event handling
Synopsis
data Event
= SysCall
| Fork
| VFork
| Clone
| VForkDone
| Exec
| Exit
data ProcessStatus
= Exited ExitCode
| Terminated Signal
| Stopped Signal
| StoppedTrace Event
getProcessStatusBoolBoolProcessIDIO (Maybe ProcessStatus)
getGroupProcessStatusBoolBoolProcessGroupIDIO (Maybe (ProcessID, ProcessStatus))
getAnyProcessStatusBoolBoolIO (Maybe (ProcessID, ProcessStatus))
Documentation
data Event
Constructors
SysCallChild has entered/exited a system call.
ForkChild has called fork().
VForkChild has called vfork().
CloneChild has called clone().
VForkDoneChild has exited a vfork() call.
ExecChild has called execve().
ExitChild is exiting. (ptrace way, stopped before exit)
show/hide Instances
data ProcessStatus
Constructors
Exited ExitCodeChild has exited with ExitCode.
Terminated SignalChild was terminated with Signal.
Stopped SignalChild was stopped with Signal.
StoppedTrace EventChild was stopped with SIGTRAP due to a ptrace Event.
getProcessStatusBoolBoolProcessIDIO (Maybe ProcessStatus)

getProcessStatus blk stopped pid calls waitpid, returning Just tc, the ProcessStatus for process pid if it is available, Nothing otherwise. If blk is False, then WNOHANG is set in the options for waitpid, otherwise not. If stopped is True, then WUNTRACED is set in the options for waitpid, otherwise not.

  • Note: Because getProcessStatus of System.Posix.Process module doesn't give information about ptrace events, this is a re-implementation that gives information about ptrace events.
  • Availability: Linux
getGroupProcessStatusBoolBoolProcessGroupIDIO (Maybe (ProcessID, ProcessStatus))

getGroupProcessStatus blk stopped pgid calls waitpid, returning Just (pid, tc), the ProcessID and ProcessStatus for any process in group pgid if one is available, Nothing otherwise. If blk is False, then WNOHANG is set in the options for waitpid, otherwise not. If stopped is True, then WUNTRACED is set in the options for waitpid, otherwise not.

  • Note: Because getGroupProcessStatus of System.Posix.Process module doesn't give information about ptrace events, this is a re-implementation that gives information about ptrace events.
  • Availability: Linux
getAnyProcessStatusBoolBoolIO (Maybe (ProcessID, ProcessStatus))

getAnyProcessStatus blk stopped calls waitpid, returning Just (pid, tc), the ProcessID and ProcessStatus for any child process if one is available, Nothing otherwise. If blk is False, then WNOHANG is set in the options for waitpid, otherwise not. If stopped is True, then WUNTRACED is set in the options for waitpid, otherwise not.

  • Note: Because getAnyProcessStatus of System.Posix.Process module doesn't give information about ptrace events, this is a re-implementation that gives information about ptrace events.
  • Availability: Linux
Produced by Haddock version 2.6.1