package rpc

Get desktop application:
View/edit binary Protocol Buffers messages

Represents the remote sink of supervised process events. Events from a process execution can be sent from many actors (mostly supervisor processes). The events are collected in a common place in order to reconstruct of final report of a build process.

• rpc Register (Event, google.protobuf.Empty)

  intercept.proto:36

  Register a process related events.

  message Event

  intercept.proto:45

  Represent a relevant life cycle event of a process. Currently it's only the process life cycle events (start, signal, terminate), but can be extended later with performance related events like monitoring the CPU usage or the memory allocation if those information are available.

  • uint64 rid = 1

    Required.

  • optional google.protobuf.Timestamp timestamp = 2

    Required. (ISO-8601 date-tie format with microsecond precision in UTC timezone)

  • oneof event

    Required.

    • Event.Started started = 11

    • Event.Terminated terminated = 12

    • Event.Signalled signalled = 13

This represents a (remote) supervisor process to set up program execution. A supervisor process executes a single program in the hope that it can get information about the state of the child process. But to decide what is the right strategy to intercept the relevant events from the child process is done in the external supervisor process. This interface describes a remote service which can be queried for how to execute the child program. Can resolve the executable name or update the environment variables.

• rpc Resolve (ResolveRequest, ResolveResponse)

  supervise.proto:47

  Resolve the execution for future child process.

  message ResolveRequest

  supervise.proto:51

  • optional Execution execution = 1

  message ResolveResponse

  supervise.proto:55

  • optional Execution execution = 1

Represents the supervised process received a signal.

Used in: Event

• int32 number = 1

  Required.

Represents a successful process execution.

Used in: Event

• optional Execution execution = 1

  Required.

• uint32 pid = 2

  Required.

• uint32 ppid = 3

  Optional.

Represents the termination of the supervised process.

Used in: Event

• int64 status = 1

  Optional. (Killed processes have no exit status.)

This represents the executed command itself. Describes all the context that the caller was given. And these are the those parameters which are essential for re-run the command.

Used in: Event.Started, ResolveRequest, ResolveResponse

• string executable = 1

• repeated string arguments = 2

• string working_dir = 3

• map<string, string> environment = 4