package yadcc.daemon.local

Get desktop application:
View/edit binary Protocol Buffers messages

• rpc GetVersion (GetVersionRequest, GetVersionResponse)

  messages.proto:125

  GET /local/get_version This method returns version of the running daemon.

  message GetVersionRequest

  messages.proto:21

  NOTHING.

  (message has no fields)

  message GetVersionResponse

  messages.proto:25

  • string built_at = 1

  • uint32 version_for_upgrade = 2

    @sa: `daemon/common_flags.h`

• rpc AskToLeave (AskToLeaveRequest, AskToLeaveResponse)

  messages.proto:130

  POST /local/ask_to_leave The daemon kills itself on reception of this message.

  message AskToLeaveRequest

  messages.proto:30

  NOTHING.

  (message has no fields)

  message AskToLeaveResponse

  messages.proto:34

  NOTHING.

  (message has no fields)

• rpc AcquireQuota (AcquireQuotaRequest, AcquireQuotaResponse)

  messages.proto:135

  POST /local/acquire_quota Acquire a quota for starting a new child.

  message AcquireQuotaRequest

  messages.proto:38

  • uint32 milliseconds_to_wait = 1

  • bool lightweight_task = 2

    Whether the client is expecting running this task would run quickly. The daemon may decide to allow such tasks even if all processors are already occupied (over-provisioning). This is necessary to prevent too many long-running tasks (e.g., local retry) from blocking light tasks such as preprocessing. By giving preprocessing a higher priority, we can submit tasks to the cloud more quickly. (i.e., QoS of local tasks.)

  • uint32 requestor_pid = 3

    The caller should provide its PID here. If it crashed unexpectedly, the delegate daemon can automatically reclaim the quota allocated to this requestor when this PID cease to exist.

  message AcquireQuotaResponse

  messages.proto:57

  Nothing. Check out HTTP status code for operation result.

  (message has no fields)

• rpc ReleaseQuota (ReleaseQuotaRequest, ReleaseQuotaResponse)

  messages.proto:140

  POST /local/release_quota Release quota previously granted.

  message ReleaseQuotaRequest

  messages.proto:64

  • uint32 requestor_pid = 1

  message ReleaseQuotaResponse

  messages.proto:68

  Nothing. Check out HTTP status code for operation result.

  (message has no fields)

• rpc SetFileDigest (SetFileDigestRequest, SetFileDigestResponse)

  messages.proto:145

  POST /local/set_file_digest Tell the daemon about BLAKE3 digest of an on-disk file.

  message SetFileDigestRequest

  messages.proto:86

  Report file digest to local daemon. In certain cases the daemon may need file digest of some file (e.g., compiler's). Because daemon can be possibly run under different user of the client, the daemon may or may not have access to the compiler. Therefore, we ask the client to calculate the compiler's digest and report it to the daemon.

  • optional FileDesc file_desc = 1

  • string digest = 2

    Usually is a BLAKE3 hash, hex encoded.

  message SetFileDigestResponse

  messages.proto:91

  NOTHING.

  (message has no fields)

• rpc SubmitCxxTask (SubmitCxxTaskRequest, SubmitCxxTaskResponse)

  messages.proto:150

  POST /local/submit_cxx_task Submit a C++ compilation task.

  message SubmitCxxTaskRequest

  messages.proto:95

  • int32 requestor_process_id = 1

  • string source_path = 2

  • string source_digest = 3

  • string compiler_invocation_arguments = 4

  • int32 cache_control = 5

  • optional FileDesc compiler = 6

  message SubmitCxxTaskResponse

  messages.proto:104

  • uint64 task_id = 1

    Encoded as string in JSON.

• rpc WaitForCxxTask (WaitForCxxTaskRequest, WaitForCxxTaskResponse)

  messages.proto:155

  POST /local/wait_for_cxx_task Wait for a previously-submitted C++ task to complete.

  message WaitForCxxTaskRequest

  messages.proto:108

  • uint64 task_id = 1

    Encoded as string in JSON.

  • uint32 milliseconds_to_wait = 2

  message WaitForCxxTaskResponse

  messages.proto:113

  • int32 exit_code = 1

  • string output = 2

    stdout

  • string error = 3

    stderr

  • repeated string file_extensions = 4

  • repeated patch.Locations patches = 5

This message uses several easy-to-get attributes to describe a file.

Used in: SetFileDigestRequest, SubmitCxxTaskRequest

• string path = 1

• uint64 size = 2

• uint64 timestamp = 3