rktimes.c File Reference

Detailed Description

Main file for a sampling time(1)-like command.

Unlike time(1) though, it will not wait until the end of a run to report the CPU usage, it continuously reports the usage in a form fit for consumption by gnuplot. In addition, it can act as a server for a GKrellm client so the data can be viewed instantaneously in a nice GUI.

Definition in file rktimes.c.

Include dependency graph for rktimes.c:

Go to the source code of this file.

Defines

#define SAMPLES_PER_SECOND   1

Number of times per second to record CPU usage samples.

#define MAX_CLIENTS   8

Maximum number of gkrellm clients.

#define CLIENT_BUFFER_MAX   4096

Size of the buffer used to format gkrellm output.

#define __XSTRING(x)   __STRING(x)

Convert a macro argument to a string.

#define my_perror(x)   perror(x ", file " __FILE__ ", line " __XSTRING(__LINE__))

A version of perror(3) that prints out the file and line number.

#define MAX_PROC_LIST   128

Maximum number of processes to query in the resource set.

Enumerations

enum { RKTB_DONE, RKTB_CREATED_RESOURCE_SET }

enum { RKTF_DONE = (1L << RKTB_DONE), RKTF_CREATED_RESOURCE_SET = (1L << RKTB_CREATED_RESOURCE_SET) }

enum { RKTB_CLIENT_INITIALIZED }

enum { RKTF_CLIENT_INITIALIZED = (1L << RKTB_CLIENT_INITIALIZED) }

Functions

void rktClientWrite (unsigned int index, const char *buffer, size_t len)

Write a byte array to a client's socket.

void sigpass (int sig)

A signal handler that passes the received signal on to the child process.

void sigalrm (int sig)

The SIGALRM signal handler.

void sigchld (int sig)

Handle a SIGCHLD signal.

void sigexit (int sig)

Handle a SIGINT/SIGTERM signal when no utility is being monitored.

void sigio (int sig)

Handle a SIGIO signal.

rk_resource_set_t rktCreateSelfResourceSet (char *name)

Create a resource set and CPU reserve for ourself.

rk_resource_set_t rktGetChildResourceSet (rk_resource_set_t rs, const char *requested_name, const char *default_name, unsigned int child_period, unsigned int child_compute)

Get a resource set for the child process.

void rktUsage (FILE *file, char *prog_name)

Print out the usage statement to a file handle.

int rktProcessOptions (int *argc_inout, char **argv_inout[])

Process the command line options.

int rktParentPart (rk_resource_set_t rs)

The parent portion of the fork(2) between rktimes and the monitored utility.

int rktChildPart (rk_resource_set_t rs, char *argv[])

The child portion of the fork(2) between rktimes and the monitored utility.

int main (int argc, char *argv[])

Variables

struct {

   unsigned long   rkt_Flags

   const char *   rkt_UtilityName

   timeval   rkt_StartTime

   const char *   rkt_OutputBase

   const char *   rkt_Name

   unsigned int   rkt_ChildPeriod

   unsigned int   rkt_ChildCompute

   rk_resource_set_t   rkt_ResourceSet

   pid_t   rkt_ChildPID

   int   rkt_ServerSocket

   char   rkt_ClientBuffer [CLIENT_BUFFER_MAX]

   int   rkt_ClientSockets [MAX_CLIENTS]

   unsigned long   rkt_ClientFlags [MAX_CLIENTS]

} rktimes_data

Define Documentation

#define __XSTRING ( x ) __STRING(x)

Convert a macro argument to a string.

Parameters:

x The macro to expand to a string.

Definition at line 73 of file rktimes.c.

#define my_perror ( x ) perror(x ", file " __FILE__ ", line " __XSTRING(__LINE__))

A version of perror(3) that prints out the file and line number.

Parameters:

x The prefix string for the error string.

Definition at line 81 of file rktimes.c.
Referenced by rktChildPart(), rktCreateSelfResourceSet(), rktGetChildResourceSet(), rktParentPart(), rktProcessOptions(), sigalrm(), and sigpass().

Function Documentation

int rktChildPart ( rk_resource_set_t rs,

char * argv[]

) [static]

The child portion of the fork(2) between rktimes and the monitored utility.
This function will attach the child to the given resource set and execvp(3) the utility to monitor with the given arguments.

Parameters:

rs The child's resource set.

argv The utility to startup and its arguments.

Returns:
A failure exit code, otherwise this function will not return because of the execvp(3).

See also:
rktParentPart

Definition at line 1072 of file rktimes.c.
References ensure, my_perror, NULL_RESOURCE_SET, require, rk_inherit_mode(), rk_resource_set_attach_process(), and rk_resource_set_t.