dragon.infrastructure.messages

Components in the Dragon runtime interact with each other using messages transported with a variety of different means (e.g., stdout or Channels). Although typically there will be a Python API to construct and send these messages, the messages themselves constitute the true internal interface. To that end, they are a convention.

Here we document this internal message API.

Generalities about Messages

Many messages are part of a request/response pair. At the level discussed here, successful and error responses are carried by the same response type but the fields present or valid may change according to whether the response is successful or an error.

All messages are serialized using JSON; the reason for this is to allow non-Python actors to interact with the Dragon infrastructure as well as allowing the possibility for the different components of the Dragon runtime to be implemented in something other than Python.

The serialization method may change in the future as an optimization; JSON is chosen here as a reasonable cross language starting point. In particular, the fields discussed here for basic message parsing (type and instance tagging, and errors) are defined in terms of integer valued enumerations suitable for a fixed field location and width binary determination.

The top level of the JSON structure will be a dictionary (map) where the ‘_tc’ key’s value is an integer corresponding to an element of the dragon.messages.MsgTypes enumeration class. The other fields of this map will be defined on a message by message basis.

The canonical form of the message will be taken on the JSON level, not the string level. This means that messages should not be compared or sorted as strings. Internally the Python interface will construct inbound messages into class objects of distinct type according to the ‘_tc’ field in the initializer by using a factory function. The reason to have a lot of different message types instead of just one type differentiated by the value of the ‘_tc’ field is that this allows IDEs and documentation tools to work better by having explicit knowledge of what fields and methods are expected in any particular message.

Common Fields

These fields are common to every message described below depending on their category of classification.

The _tc TypeCode Field

The _tc typecode field is used during parsing to determine the type of a received message. The message format is JSON. The _tc field can be used to determine of all expected fields of a message are indeed in the message to verify its format.

Beyond the _tc typecode field, there are other fields expected to belong to every message.

The tag Field

Every message has a 64 bit positive unsigned integer tag field. Together with the identity of the sender is implicit or explicitly identified in some other field, this serves to uniquely identify the message.

Ideally, this would be throughout the life of the runtime, but it’s enough to say that no two messages should be simultaneously relevant with the same (sender, tag).

Message Categories

There are three general categories of messages:
  • request messages, where one entity asks another one to do something

  • response messages, returning the result to the requester
    • the name of these messages normally ends “Response”

  • other messages, mostly to do with infrastructure sequencing

Every request message will contain p_uid and r_c_uid fields. These fields denote the unique process ID of the entity that created the request and the unique channel ID to send the response to. See ConventionalIDs for more details on process identification.

The ref Field

Every response message generated in reply to a request message will contain a ref field that echos the tag field of the request message that caused it to be generated. If a response message is generated asynchronously - for instance, as part of a startup notification or some event such as a process exiting unexpectedly - then the ref field will be 0, which is an illegal value for the tag field.

The err Field

Every response message will also have an err field, holding an integer enumeration particular to the response. This enumeration will be the class attribute Errors in the response message class. The enumeration element with value 0 will always indicate success. Which fields are present in the response message may depend on the enumeration value.

Format of Messages List

  1. Class Name

    type enum

    member of dragon.messages.MsgTypes enum class

    purpose

    succinct description of purpose, sender and receiver, where and when typically seen. Starts with ‘Request’ if it is a request message and ‘Response’ if it is a response message.

    fields

    Fields in the message, together with description of how they are to get parsed out. Some fields may themselves be dictionary structures used to initialize member objects.

    Fields in common to every message (such as tag, ref, and err) are not mentioned here.

    An expected type will be mentioned on each field where it is an obvious primitive (such as a string or an integer). Where a type isn’t mentioned, it is assumed to be another key-value map to be interpreted as the initializer for some more complex type.

    response

    If a request kind of message, gives the class name of the corresponding response message, if applicable

    request

    If a request kind of message, gives the class name of the corresponding response message.

    see also

    Other related messages

Functions

camel_case_msg_name(msg_id)

mk_all_message_classes_set()

parse(serialized[, restrict])

type_filter(the_msg_types)

Classes

AbnormalTermination

Refer to Common Fields for a description of the message structure.

BEHaltOverlay

Refer to Common Fields for a description of the message structure.

BEHalted

Refer to Common Fields for a description of the message structure.

BEIsUp

Refer to Common Fields for a description of the message structure.

BENodeIdxSH

Refer to Common Fields for a description of the message structure.

BEPingSH

Refer to Common Fields for a description of the message structure.

Breakpoint

CapNProtoMsg

Common base for all capnproto messages.

CapNProtoResponseMsg

Common base for all capnproto response messages.

DDAdvance

DDAdvanceResponse

DDBPut

DDBPutResponse

DDBatchPut

DDBatchPutResponse

DDChkptAvail

DDChkptAvailResponse

DDClear

DDClearResponse

DDConnectToManager

DDConnectToManagerResponse

DDContains

DDContainsResponse

DDCreate

DDCreateResponse

DDDeregisterClient

DDDeregisterClientResponse

DDDestroy

DDDestroyManager

DDDestroyManagerResponse

DDDestroyResponse

DDEmptyManagers

DDEmptyManagersResponse

DDFreeze

DDFreezeResponse

DDGet

DDGetFreeze

DDGetFreezeResponse

DDGetManagers

DDGetManagersResponse

DDGetMetaData

DDGetMetaDataResponse

DDGetResponse

DDItems

DDItemsResponse

DDIterator

DDIteratorNext

DDIteratorNextResponse

DDIteratorResponse

DDKeys

DDKeysResponse

DDLength

DDLengthResponse

DDManagerNewestChkptID

DDManagerNewestChkptIDResponse

DDManagerNodes

DDManagerNodesResponse

DDManagerSetState

DDManagerSetStateResponse

DDManagerStats

DDManagerStatsResponse

DDManagerSync

DDManagerSyncResponse

DDMarkDrainedManagers

DDMarkDrainedManagersResponse

DDPersist

DDPersistChkpts

DDPersistChkptsResponse

DDPersistResponse

DDPersistedChkptAvail

DDPersistedChkptAvailResponse

DDPop

DDPopResponse

DDPut

DDPutResponse

DDRandomManager

DDRandomManagerResponse

DDRegisterClient

DDRegisterClientID

DDRegisterClientIDResponse

DDRegisterClientResponse

DDRegisterManager

DDRegisterManagerResponse

DDRestore

DDRestoreResponse

DDUnFreeze

DDUnFreezeResponse

DDUnmarkDrainedManagers

DDUnmarkDrainedManagersResponse

DDValues

DDValuesResponse

ExceptionlessAbort

Refer to Common Fields for a description of the message structure.

FENodeIdxBE

Refer to Common Fields for a description of the message structure.

FileDescriptor

GSChannelCreate

Refer to Common Fields for a description of the message structure.

GSChannelCreateResponse

Refer to Common Fields for a description of the message structure.

GSChannelDestroy

Refer to Common Fields for a description of the message structure.

GSChannelDestroyResponse

Refer to Common Fields for a description of the message structure.

GSChannelDetach

Refer to Common Fields for a description of the message structure.

GSChannelDetachResponse

Refer to Common Fields for a description of the message structure.

GSChannelGetRecvH

Refer to Common Fields for a description of the message structure.

GSChannelGetRecvHResponse

Refer to Common Fields for a description of the message structure.

GSChannelGetSendH

Refer to Common Fields for a description of the message structure.

GSChannelGetSendHResponse

Refer to Common Fields for a description of the message structure.

GSChannelJoin

Refer to Common Fields for a description of the message structure.

GSChannelJoinResponse

Refer to Common Fields for a description of the message structure.

GSChannelList

Refer to to Common Fields for a description of the message structure.

GSChannelListResponse

Refer to Common Fields for a description of the message structure.

GSChannelQuery

Refer to Common Fields for a description of the message structure.

GSChannelQueryResponse

Refer to Common Fields for a description of the message structure.

GSChannelRelease

Refer to Common Fields for a description of the message structure.

GSDumpState

Refer to Common Fields for a description of the message structure.

GSGroupAddTo

Refer to Common Fields for a description of the message structure.

GSGroupAddToResponse

Refer to Common Fields for a description of the message structure.

GSGroupCreate

Refer to Common Fields for a description of the message structure.

GSGroupCreateAddTo

Refer to Common Fields for a description of the message structure.

GSGroupCreateAddToResponse

Refer to Common Fields for a description of the message structure.

GSGroupCreateResponse

Refer to Common Fields for a description of the message structure.

GSGroupDestroy

Refer to Common Fields for a description of the message structure.

GSGroupDestroyPMIx

GSGroupDestroyPMIxResponse

GSGroupDestroyRemoveFrom

Refer to Common Fields for a description of the message structure.

GSGroupDestroyRemoveFromResponse

Refer to Common Fields for a description of the message structure.

GSGroupDestroyResponse

Refer to Common Fields for a description of the message structure.

GSGroupKill

Refer to Common Fields for a description of the message structure.

GSGroupKillResponse

Refer to Common Fields for a description of the message structure.

GSGroupList

Refer to Common Fields for a description of the message structure.

GSGroupListResponse

Refer to Common Fields for a description of the message structure.

GSGroupQuery

Refer to Common Fields for a description of the message structure.

GSGroupQueryResponse

Refer to Common Fields for a description of the message structure.

GSGroupRemoveFrom

Refer to Common Fields for a description of the message structure.

GSGroupRemoveFromResponse

Refer to Common Fields for a description of the message structure.

GSHalted

Refer to Common Fields for a description of the message structure.

GSHeadExit

Refer to Common Fields for a description of the message structure.

GSIsUp

Refer to Common Fields for a description of the message structure.

GSNodeList

type enum

GSNodeListResponse

type enum

GSNodeQuery

Refer to Common Fields for a description of the message structure.

GSNodeQueryAll

Refer to Common Fields for a description of the message structure.

GSNodeQueryAllResponse

Refer to Common Fields for a description of the message structure.

GSNodeQueryResponse

Refer to Common Fields for a description of the message structure.

GSNodeQueryTotalCPUCount

type enum

GSNodeQueryTotalCPUCountResponse

type enum

GSPingProc

Refer to Common Fields for a description of the message structure.

GSPingSH

Refer to Common Fields for a description of the message structure.

GSPoolCreate

Refer to Common Fields for a description of the message structure.

GSPoolCreateResponse

Refer to Common Fields for a description of the message structure.

GSPoolDestroy

Refer to Common Fields for a description of the message structure.

GSPoolDestroyResponse

Refer to Common Fields for a description of the message structure.

GSPoolList

Refer to Common Fields for a description of the message structure.

GSPoolListResponse

Refer to Common Fields for a description of the message structure.

GSPoolQuery

Refer to Common Fields for a description of the message structure.

GSPoolQueryResponse

Refer to Common Fields for a description of the message structure.

GSProcessCreate

Refer to Common Fields for a description of the message structure.

GSProcessCreateResponse

Refer to Common Fields for a description of the message structure.

GSProcessJoin

Refer to Common Fields for a description of the message structure.

GSProcessJoinList

Refer to Common Fields for a description of the message structure.

GSProcessJoinListResponse

Refer to Common Fields for a description of the message structure.

GSProcessJoinResponse

Refer to Common Fields for a description of the message structure.

GSProcessKill

Refer to Common Fields for a description of the message structure.

GSProcessKillResponse

Refer to Common Fields for a description of the message structure.

GSProcessList

Refer to Common Fields for a description of the message structure.

GSProcessListResponse

Refer to Common Fields for a description of the message structure.

GSProcessQuery

Refer to Common Fields for a description of the message structure.

GSProcessQueryResponse

Refer to Common Fields for a description of the message structure.

GSRebootRuntime

Refer to Common Fields for a description of the message structure.

GSRebootRuntimeResponse

Refer to Common Fields for a description of the message structure.

GSStarted

Refer to Common Fields for a description of the message structure.

GSTeardown

Refer to Common Fields for a description of the message structure.

GSUnexpected

Refer to Common Fields for a description of the message structure.

HaltLoggingInfra

Refer to Common Fields for a description of the message structure.

HaltOverlay

Refer to Common Fields for a description of the message structure.

InfraMsg

Common base for all messages.

LABroadcast

Refer to Common Fields for a description of the message structure.

LAChannelsInfo

Refer to Common Fields for a description of the message structure.

LADumpState

Refer to Common Fields for a description of the message structure.

LAExit

Refer to Common Fields for a description of the message structure.

LAHaltOverlay

Refer to Common Fields for a description of the message structure.

LAPassThruBF

Refer to Common Fields for a description of the message structure.

LAPassThruFB

Refer to Common Fields for a description of the message structure.

LAProcessDict

Refer to Common Fields for a description of the message structure.

LAProcessDictResponse

Refer to Common Fields for a description of the message structure.

LAServerMode

Refer to Common Fields for a description of the message structure.

LAServerModeExit

Refer to Common Fields for a description of the message structure.

LSDestroyPMIx

LSDestroyPMIxResponse

LogFlushed

Refer to Common Fields for a description of the message structure.

LoggingMsg

Refer to Common Fields for a description of the message structure.

LoggingMsgList

Refer to Common Fields for a description of the message structure.

MessageTypes

These are the enumerated values of message type identifiers within the Dragon infrastructure messages.

OverlayHalted

Refer to Common Fields for a description of the message structure.

OverlayPingBE

Refer to Common Fields for a description of the message structure.

OverlayPingLA

Refer to Common Fields for a description of the message structure.

PGAddProcessTemplates

PGClientResponse

Refer to Common Fields for a description of the message structure.

PGClose

PGJoin

PGPuids

PGRegisterClient

Refer to Common Fields for a description of the message structure.

PGSetProperties

PGSignal

PGStart

PGState

PGStop

PGStopRestart

PGUnregisterClient

Refer to Common Fields for a description of the message structure.

PMIGroupInfo

Required information to enable the launching of pmi based applications.

PMIProcessInfo

Required information to enable the launching of pmi based applications.

PMIxFenceMsg

RebootRuntime

Refer to definition and Common Fields for a description of the message structure.

RuntimeDesc

Refer to Common Fields for a description of the message structure.

SHAllocBlock

Refer to Common Fields for a description of the message structure.

SHAllocBlockResponse

Refer to Common Fields for a description of the message structure.

SHAllocMsg

Refer to Common Fields for a description of the message structure.

SHAllocMsgResponse

Refer to Common Fields for a description of the message structure.

SHChannelCreate

Refer to Common Fields for a description of the message structure.

SHChannelCreateResponse

Refer to Common Fields for a description of the message structure.

SHChannelDestroy

Refer to Common Fields for a description of the message structure.

SHChannelDestroyResponse

Refer to Common Fields for a description of the message structure.

SHChannelsUp

Refer to Common Fields for a description of the message structure.

SHCreateProcessLocalChannel

SHCreateProcessLocalChannelResponse

SHCreateProcessLocalPool

SHCreateProcessLocalPoolResponse

SHDeregisterProcessLocalPool

SHDeregisterProcessLocalPoolResponse

SHDestroyProcessLocalChannel

SHDestroyProcessLocalChannelResponse

SHDumpState

Refer to Common Fields for a description of the message structure.

SHExecMemRequest

Refer to Common Fields for a description of the message structure.

SHExecMemResponse

Refer to Common Fields for a description of the message structure.

SHFwdInput

Refer to Common Fields for a description of the message structure.

SHFwdInputErr

Refer to Common Fields for a description of the message structure.

SHFwdOutput

Refer to Common Fields for a description of the message structure.

SHGetKV

SHGetKVL

SHGetKVLResponse

SHGetKVResponse

SHHaltBE

Refer to Common Fields for a description of the message structure.

SHHaltTA

Refer to Common Fields for a description of the message structure.

SHHalted

Refer to Common Fields for a description of the message structure.

SHLockChannel

Refer to Common Fields for a description of the message structure.

SHLockChannelResponse

Refer to Common Fields for a description of the message structure.

SHMultiProcessCreate

SHMultiProcessCreateResponse

SHMultiProcessKill

SHMultiProcessKillResponse

SHPingBE

Refer to Common Fields for a description of the message structure.

SHPingGS

Refer to Common Fields for a description of the message structure.

SHPoolCreate

Refer to Common Fields for a description of the message structure.

SHPoolCreateResponse

Refer to Common Fields for a description of the message structure.

SHPoolDestroy

Refer to to the Common Fields for a description of the message structure.

SHPoolDestroyResponse

Refer to Common Fields for a description of the message structure.

SHPopKVL

SHPopKVLResponse

SHProcessCreate

Refer to Common Fields for a description of the message structure.

SHProcessCreateResponse

Refer to Common Fields for a description of the message structure.

SHProcessExit

Refer to to Common Fields for a description of the message structure.

SHProcessKill

Refer to Common Fields for a description of the message structure.

SHProcessKillResponse

SHPushKVL

SHPushKVLResponse

SHRegisterProcessLocalPool

SHRegisterProcessLocalPoolResponse

SHSetKV

SHSetKVResponse

SHTeardown

Refer to Common Fields for a description of the message structure.

TAHalted

Refer to Common Fields for a description of the message structure.

TAPingSH

Refer to Common Fields for a description of the message structure.

TAUp

Refer to Common Fields for a description of the message structure.

TAUpdateNodes

Refer to Common Fields for a description of the message structure.

UserHaltOOB

Refer to Common Fields for a description of the message structure.

Exceptions

AbnormalTerminationError

class MessageTypes[source]

Bases: Enum

These are the enumerated values of message type identifiers within the Dragon infrastructure messages.

DRAGON_MSG = 0

Deliberately invalid

GS_PROCESS_CREATE = 1
GS_PROCESS_CREATE_RESPONSE = 2
GS_PROCESS_LIST = 3
GS_PROCESS_LIST_RESPONSE = 4
GS_PROCESS_QUERY = 5
GS_PROCESS_QUERY_RESPONSE = 6
GS_PROCESS_KILL = 7
GS_PROCESS_KILL_RESPONSE = 8
GS_PROCESS_JOIN = 9
GS_PROCESS_JOIN_RESPONSE = 10
GS_CHANNEL_CREATE = 11
GS_CHANNEL_CREATE_RESPONSE = 12
GS_CHANNEL_LIST = 13
GS_CHANNEL_LIST_RESPONSE = 14
GS_CHANNEL_QUERY = 15
GS_CHANNEL_QUERY_RESPONSE = 16
GS_CHANNEL_DESTROY = 17
GS_CHANNEL_DESTROY_RESPONSE = 18
GS_CHANNEL_JOIN = 19
GS_CHANNEL_JOIN_RESPONSE = 20
GS_CHANNEL_DETACH = 21
GS_CHANNEL_DETACH_RESPONSE = 22
GS_CHANNEL_GET_SENDH = 23
GS_CHANNEL_GET_SENDH_RESPONSE = 24
GS_CHANNEL_GET_RECVH = 25
GS_CHANNEL_GET_RECVH_RESPONSE = 26
ABNORMAL_TERMINATION = 27
GS_STARTED = 28
GS_PING_SH = 29
GS_IS_UP = 30
GS_HEAD_EXIT = 31
GS_CHANNEL_RELEASE = 32
GS_HALTED = 33
SH_PROCESS_CREATE = 34
SH_PROCESS_CREATE_RESPONSE = 35
SH_MULTI_PROCESS_CREATE = 36
SH_MULTI_PROCESS_CREATE_RESPONSE = 37
SH_MULTI_PROCESS_KILL = 38
SH_PROCESS_KILL = 39
SH_PROCESS_EXIT = 40
SH_CHANNEL_CREATE = 41
SH_CHANNEL_CREATE_RESPONSE = 42
SH_CHANNEL_DESTROY = 43
SH_CHANNEL_DESTROY_RESPONSE = 44
SH_LOCK_CHANNEL = 45
SH_LOCK_CHANNEL_RESPONSE = 46
SH_ALLOC_MSG = 47
SH_ALLOC_MSG_RESPONSE = 48
SH_ALLOC_BLOCK = 49
SH_ALLOC_BLOCK_RESPONSE = 50
SH_CHANNELS_UP = 51
SH_PING_GS = 52
SH_HALTED = 53
SH_FWD_INPUT = 54
SH_FWD_INPUT_ERR = 55
SH_FWD_OUTPUT = 56
GS_TEARDOWN = 57
SH_TEARDOWN = 58
SH_PING_BE = 59
BE_PING_SH = 60
TA_PING_SH = 61
SH_HALT_TA = 62
TA_HALTED = 63
SH_HALT_BE = 64
BE_HALTED = 65
TA_UP = 66
GS_PING_PROC = 67
GS_DUMP_STATE = 68
SH_DUMP_STATE = 69
LA_BROADCAST = 70
LA_PASS_THRU_FB = 71
LA_PASS_THRU_BF = 72
GS_POOL_CREATE = 73
GS_POOL_CREATE_RESPONSE = 74
GS_POOL_DESTROY = 75
GS_POOL_DESTROY_RESPONSE = 76
GS_POOL_LIST = 77
GS_POOL_LIST_RESPONSE = 78
GS_POOL_QUERY = 79
GS_POOL_QUERY_RESPONSE = 80
SH_POOL_CREATE = 81
SH_POOL_CREATE_RESPONSE = 82
SH_POOL_DESTROY = 83
SH_POOL_DESTROY_RESPONSE = 84
SH_CREATE_PROCESS_LOCAL_CHANNEL = 85
SH_CREATE_PROCESS_LOCAL_CHANNEL_RESPONSE = 86
SH_DESTROY_PROCESS_LOCAL_CHANNEL = 87
SH_DESTROY_PROCESS_LOCAL_CHANNEL_RESPONSE = 88
SH_CREATE_PROCESS_LOCAL_POOL = 89
SH_CREATE_PROCESS_LOCAL_POOL_RESPONSE = 90
SH_REGISTER_PROCESS_LOCAL_POOL = 91
SH_REGISTER_PROCESS_LOCAL_POOL_RESPONSE = 92
SH_DEREGISTER_PROCESS_LOCAL_POOL = 93
SH_DEREGISTER_PROCESS_LOCAL_POOL_RESPONSE = 94
SH_PUSH_KVL = 95
SH_PUSH_KVL_RESPONSE = 96
SH_POP_KVL = 97
SH_POP_KVL_RESPONSE = 98
SH_GET_KVL = 99
SH_GET_KVL_RESPONSE = 100
SH_SET_KV = 101
SH_SET_KV_RESPONSE = 102
SH_GET_KV = 103
SH_GET_KV_RESPONSE = 104
SH_EXEC_MEM_REQUEST = 105
SH_EXEC_MEM_RESPONSE = 106
LS_DESTROY_PMIX = 107
LS_DESTROY_PMIX_RESPONSE = 108
GS_UNEXPECTED = 109
LA_SERVER_MODE = 110
LA_SERVER_MODE_EXIT = 111
LA_PROCESS_DICT = 112
LA_PROCESS_DICT_RESPONSE = 113
LA_DUMP_STATE = 114
BE_NODE_IDX_SH = 115
LA_CHANNELS_INFO = 116
SH_MULTI_PROCESS_KILL_RESPONSE = 117
SH_PROCESS_KILL_RESPONSE = 118
BREAKPOINT = 119
GS_PROCESS_JOIN_LIST = 120
GS_PROCESS_JOIN_LIST_RESPONSE = 121
GS_NODE_QUERY = 122
GS_NODE_QUERY_RESPONSE = 123
GS_NODE_QUERY_ALL = 124
GS_NODE_QUERY_ALL_RESPONSE = 125
LOGGING_MSG = 126
LOGGING_MSG_LIST = 127
LOG_FLUSHED = 128
GS_NODE_LIST = 129
GS_NODE_LIST_RESPONSE = 130
GS_NODE_QUERY_TOTAL_CPU_COUNT = 131
GS_NODE_QUERY_TOTAL_CPU_COUNT_RESPONSE = 132
BE_IS_UP = 133
FE_NODE_IDX_BE = 134
HALT_OVERLAY = 135
HALT_LOGGING_INFRA = 136
OVERLAY_PING_BE = 137
OVERLAY_PING_LA = 138
LA_HALT_OVERLAY = 139
BE_HALT_OVERLAY = 140
OVERLAY_HALTED = 141
EXCEPTIONLESS_ABORT = 142

Communicate abnormal termination without raising exception

LA_EXIT = 143
GS_GROUP_LIST = 144
GS_GROUP_LIST_RESPONSE = 145
GS_GROUP_QUERY = 146
GS_GROUP_QUERY_RESPONSE = 147
GS_GROUP_DESTROY = 148
GS_GROUP_DESTROY_RESPONSE = 149
GS_GROUP_ADD_TO = 150
GS_GROUP_ADD_TO_RESPONSE = 151
GS_GROUP_REMOVE_FROM = 152
GS_GROUP_REMOVE_FROM_RESPONSE = 153
GS_GROUP_CREATE = 154
GS_GROUP_CREATE_RESPONSE = 155
GS_GROUP_KILL = 156
GS_GROUP_KILL_RESPONSE = 157
GS_GROUP_CREATE_ADD_TO = 158
GS_GROUP_CREATE_ADD_TO_RESPONSE = 159
GS_GROUP_DESTROY_REMOVE_FROM = 160
GS_GROUP_DESTROY_REMOVE_FROM_RESPONSE = 161
GS_GROUP_DESTROY_PMIX = 162
GS_GROUP_DESTROY_PMIX_RESPONSE = 163
GS_REBOOT_RUNTIME = 164
GS_REBOOT_RUNTIME_RESPONSE = 165
REBOOT_RUNTIME = 166
TA_UPDATE_NODES = 167
RUNTIME_DESC = 168
USER_HALT_OOB = 169
DD_REGISTER_CLIENT = 170
DD_REGISTER_CLIENT_RESPONSE = 171
DD_DESTROY = 172
DD_DESTROY_RESPONSE = 173
DD_REGISTER_MANAGER = 174
DD_REGISTER_MANAGER_RESPONSE = 175
DD_REGISTER_CLIENT_ID = 176
DD_REGISTER_CLIENT_ID_RESPONSE = 177
DD_DESTROY_MANAGER = 178
DD_DESTROY_MANAGER_RESPONSE = 179
DD_PUT = 180
DD_PUT_RESPONSE = 181
DD_GET = 182
DD_GET_RESPONSE = 183
DD_POP = 184
DD_POP_RESPONSE = 185
DD_CONTAINS = 186
DD_CONTAINS_RESPONSE = 187
DD_LENGTH = 188
DD_LENGTH_RESPONSE = 189
DD_CLEAR = 190
DD_CLEAR_RESPONSE = 191
DD_ITERATOR = 192
DD_ITERATOR_RESPONSE = 193
DD_ITERATOR_NEXT = 194
DD_ITERATOR_NEXT_RESPONSE = 195
DD_KEYS = 196
DD_KEYS_RESPONSE = 197
DD_VALUES = 198
DD_VALUES_RESPONSE = 199
DD_ITEMS = 200
DD_ITEMS_RESPONSE = 201
DD_DEREGISTER_CLIENT = 202
DD_DEREGISTER_CLIENT_RESPONSE = 203
DD_CREATE = 204
DD_CREATE_RESPONSE = 205
DD_CONNECT_TO_MANAGER = 206
DD_CONNECT_TO_MANAGER_RESPONSE = 207
DD_RANDOM_MANAGER = 208
DD_RANDOM_MANAGER_RESPONSE = 209
DD_MANAGER_STATS = 210
DD_MANAGER_STATS_RESPONSE = 211
DD_MANAGER_NEWEST_CHKPT_ID = 212
DD_MANAGER_NEWEST_CHKPT_ID_RESPONSE = 213
DD_EMPTY_MANAGERS = 214
DD_EMPTY_MANAGERS_RESPONSE = 215
DD_BATCH_PUT = 216
DD_BATCH_PUT_RESPONSE = 217
DD_GET_MANAGERS = 218
DD_GET_MANAGERS_RESPONSE = 219
DD_MANAGER_SYNC = 220
DD_MANAGER_SYNC_RESPONSE = 221
DD_MANAGER_SET_STATE = 222
DD_MANAGER_SET_STATE_RESPONSE = 223
DD_MARK_DRAINED_MANAGERS = 224
DD_MARK_DRAINED_MANAGERS_RESPONSE = 225
DD_UNMARK_DRAINED_MANAGERS = 226
DD_UNMARK_DRAINED_MANAGERS_RESPONSE = 227
DD_GET_META_DATA = 228
DD_GET_META_DATA_RESPONSE = 229
DD_MANAGER_NODES = 230
DD_MANAGER_NODES_RESPONSE = 231
DD_B_PUT = 232
DD_B_PUT_RESPONSE = 233
DD_PERSISTED_CHKPT_AVAIL = 234
DD_PERSISTED_CHKPT_AVAIL_RESPONSE = 235
DD_RESTORE = 236
DD_RESTORE_RESPONSE = 237
DD_ADVANCE = 238
DD_ADVANCE_RESPONSE = 239
DD_PERSIST_CHKPTS = 240
DD_PERSIST_CHKPTS_RESPONSE = 241
DD_CHKPT_AVAIL = 242
DD_CHKPT_AVAIL_RESPONSE = 243
DD_GET_FREEZE = 244
DD_GET_FREEZE_RESPONSE = 245
DD_FREEZE = 246
DD_FREEZE_RESPONSE = 247
DD_UN_FREEZE = 248
DD_UN_FREEZE_RESPONSE = 249
DD_PERSIST = 250
DD_PERSIST_RESPONSE = 251
PG_REGISTER_CLIENT = 252
PG_UNREGISTER_CLIENT = 253
PG_CLIENT_RESPONSE = 254
PG_SET_PROPERTIES = 255
PG_STOP_RESTART = 256
PG_ADD_PROCESS_TEMPLATES = 257
PG_START = 258
PG_JOIN = 259
PG_SIGNAL = 260
PG_STATE = 261
PG_PUIDS = 262
PG_STOP = 263
PG_CLOSE = 264
PMIX_FENCE_MSG = 265
class FileDescriptor[source]

Bases: Enum

stdin = 0
stdout = 1
stderr = 2
exception AbnormalTerminationError[source]

Bases: Exception

__init__(msg='')[source]
class PMIGroupInfo[source]

Bases: object

Required information to enable the launching of pmi based applications.

backend: PMIBackend
job_id: int
nnodes: int
nranks: int
nid_map: dict [int , int ]
host_map: dict [int , str ]
control_port: int
pmix_desc: str
classmethod fromdict(d)[source]
__init__(backend: PMIBackend, job_id: int , nnodes: int , nranks: int , nid_map: dict [int , int ], host_map: dict [int , str ], control_port: int , pmix_desc: str ) None
class PMIProcessInfo[source]

Bases: object

Required information to enable the launching of pmi based applications.

lrank: int
ppn: int
nid: int
pmix_nid: int
pid_base: int
classmethod fromdict(d)[source]
__init__(lrank: int , ppn: int , nid: int , pmix_nid: int , pid_base: int ) None
class InfraMsg[source]

Bases: object

Common base for all messages.

This common base type for all messages sets up the default fields and the serialization strategy for now.

class Errors[source]

Bases: Enum

INVALID = -1
__init__(tag, ref=None, err=None)[source]
get_sdict()[source]
property tc
classmethod tcv()[source]
property tag
property ref
property err
classmethod from_sdict(sdict)[source]
classmethod deserialize(msg)[source]
uncompressed_serialize()[source]
serialize()[source]
class CapNProtoMsg[source]

Bases: object

Common base for all capnproto messages.

This common base type for all messages sets up the default fields and the serialization strategy for messages to be exchanged between C and Python.

Errors

alias of DragonError

__init__(tag)[source]
classmethod from_sdict(sdict)[source]
classmethod deserialize(msg_str)[source]
serialize()[source]
get_sdict()[source]
builder()[source]
property capnp_name
property tc
property tag
class CapNProtoResponseMsg[source]

Bases: CapNProtoMsg

Common base for all capnproto response messages.

This provides some support for code common to all response messages.

__init__(tag, ref, err, errInfo)[source]
get_sdict()[source]
builder()[source]
property ref
property err
property errInfo
class SHCreateProcessLocalChannel[source]

Bases: CapNProtoMsg

__init__(tag, puid, muid, blockSize, capacity, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
property puid
property muid
property blockSize
property capacity
class SHCreateProcessLocalChannelResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', serChannel='')[source]
get_sdict()[source]
builder()[source]
property serialized_channel
class SHDestroyProcessLocalChannel[source]

Bases: CapNProtoMsg

__init__(tag, puid, cuid, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
property puid
property cuid
class SHDestroyProcessLocalChannelResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHCreateProcessLocalPool[source]

Bases: CapNProtoMsg

__init__(tag, puid, size, minBlockSize, preAllocs, name, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
property puid
property size
property minBlockSize
property preAllocs
property name
class SHCreateProcessLocalPoolResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', serPool='')[source]
get_sdict()[source]
builder()[source]
property serialized_pool
class SHRegisterProcessLocalPool[source]

Bases: CapNProtoMsg

__init__(tag, puid, serPool, respFLI)[source]
get_sdict()[source]
builder()[source]
property serPool
property puid
property respFLI
class SHRegisterProcessLocalPoolResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHDeregisterProcessLocalPool[source]

Bases: CapNProtoMsg

__init__(tag, puid, serPool, respFLI)[source]
get_sdict()[source]
builder()[source]
property serPool
property puid
property respFLI
class SHDeregisterProcessLocalPoolResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHPushKVL[source]

Bases: CapNProtoMsg

__init__(tag, key, value, respFLI)[source]
get_sdict()[source]
builder()[source]
property key
property value
property respFLI
class SHPushKVLResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHPopKVL[source]

Bases: CapNProtoMsg

__init__(tag, key, value, respFLI)[source]
get_sdict()[source]
builder()[source]
property key
property value
property respFLI
class SHPopKVLResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHGetKVL[source]

Bases: CapNProtoMsg

__init__(tag, key, respFLI)[source]
get_sdict()[source]
builder()[source]
property key
property respFLI
class SHGetKVLResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', values=[])[source]
get_sdict()[source]
builder()[source]
property values
class SHSetKV[source]

Bases: CapNProtoMsg

__init__(tag, key, value, respFLI)[source]
get_sdict()[source]
builder()[source]
property key
property value
property respFLI
class SHSetKVResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class SHGetKV[source]

Bases: CapNProtoMsg

__init__(tag, key, respFLI)[source]
get_sdict()[source]
builder()[source]
property key
property respFLI
class SHGetKVResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', value=None)[source]
get_sdict()[source]
builder()[source]
property value
class DDCreate[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, args)[source]
get_sdict()[source]
builder()[source]
property respFLI
property args
class DDCreateResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDRandomManager[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDRandomManagerResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, manager, managerID, errInfo='')[source]
get_sdict()[source]
builder()[source]
property manager
property managerID
class DDRegisterClient[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, bufferedRespFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
property bufferedRespFLI
class DDRegisterClientResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, clientID, numManagers, managerID, managerNodes, name, timeout, errInfo='')[source]
get_sdict()[source]
builder()[source]
property clientID
property numManagers
property managerID
property managerNodes
property name
property timeout
class DDConnectToManager[source]

Bases: CapNProtoMsg

__init__(tag, clientID, managerID)[source]
get_sdict()[source]
builder()[source]
property clientID
property managerID
class DDConnectToManagerResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, manager, errInfo='')[source]
get_sdict()[source]
builder()[source]
property manager
class DDDestroy[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI, allowRestart)[source]
get_sdict()[source]
builder()[source]
property respFLI
property clientID
property allowRestart
class DDDestroyResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDRegisterManager[source]

Bases: CapNProtoMsg

__init__(tag, managerID, mainFLI, respFLI, hostID, poolSdesc, err, errInfo)[source]
get_sdict()[source]
builder()[source]
property managerID
property mainFLI
property respFLI
property hostID
property poolSdesc
property err
property errInfo
class DDRegisterManagerResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, managers, managerNodes)[source]
get_sdict()[source]
builder()[source]
property managers
property managerNodes
class DDRegisterClientID[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI, bufferedRespFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property respFLI
property bufferedRespFLI
class DDRegisterClientIDResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDDestroyManager[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, allowRestart)[source]
get_sdict()[source]
builder()[source]
property respFLI
property allowRestart
class DDDestroyManagerResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDPut[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID=0, persist=True)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property persist
class DDPutResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDGet[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, key)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property key
class DDGetResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', freeMem=False)[source]
get_sdict()[source]
builder()[source]
property freeMem
class DDPop[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, key)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property key
class DDPopResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', freeMem=False)[source]
get_sdict()[source]
builder()[source]
property freeMem
class DDContains[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, key)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property key
class DDContainsResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDLength[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI, chkptID=0, broadcast=True)[source]
get_sdict()[source]
builder()[source]
property clientID
property respFLI
property chkptID
property broadcast
class DDLengthResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', length=0)[source]
get_sdict()[source]
builder()[source]
property length
class DDClear[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, respFLI, broadcast=True)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property respFLI
property broadcast
class DDClearResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDManagerStats[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, broadcast=True)[source]
get_sdict()[source]
builder()[source]
property respFLI
property broadcast
class DDManagerStatsResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', data='')[source]
get_sdict()[source]
builder()[source]
property data
class DDManagerNewestChkptID[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, broadcast=True)[source]
get_sdict()[source]
builder()[source]
property respFLI
property broadcast
class DDManagerNewestChkptIDResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', managerID=0, chkptID=0)[source]
get_sdict()[source]
builder()[source]
property chkptID
property managerID
class DDIterator[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID=0)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
class DDIteratorResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', iterID=0)[source]
get_sdict()[source]
builder()[source]
property iterID
class DDIteratorNext[source]

Bases: CapNProtoMsg

__init__(tag, clientID, iterID)[source]
get_sdict()[source]
builder()[source]
property clientID
property iterID
class DDIteratorNextResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDKeys[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property respFLI
class DDKeysResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDValues[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property respFLI
class DDValuesResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', freeMem=False)[source]
get_sdict()[source]
builder()[source]
property freeMem
class DDItems[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property respFLI
class DDItemsResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='', freeMem=False)[source]
get_sdict()[source]
builder()[source]
property freeMem
class DDEmptyManagers[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDEmptyManagersResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, managers)[source]
get_sdict()[source]
builder()[source]
property managers
class DDBatchPut[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID=0, persist=True)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property persist
class DDBatchPutResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, numPuts, managerID)[source]
get_sdict()[source]
builder()[source]
property numPuts
property managerID
class DDGetManagers[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDGetManagersResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, emptyManagers, managers)[source]
get_sdict()[source]
builder()[source]
property emptyManagers
property managers
class DDManagerSync[source]

Bases: CapNProtoMsg

__init__(tag, emptyManagerFLI, respFLI)[source]
get_sdict()[source]
builder()[source]
property emptyManagerFLI
property respFLI
class DDManagerSyncResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDManagerSetState[source]

Bases: CapNProtoMsg

__init__(tag, state, respFLI)[source]
get_sdict()[source]
builder()[source]
property state
property respFLI
class DDManagerSetStateResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDMarkDrainedManagers[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, managerIDs)[source]
get_sdict()[source]
builder()[source]
property respFLI
property managerIDs
class DDMarkDrainedManagersResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDUnmarkDrainedManagers[source]

Bases: CapNProtoMsg

__init__(tag, respFLI, managerIDs)[source]
get_sdict()[source]
builder()[source]
property respFLI
property managerIDs
class DDUnmarkDrainedManagersResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDGetMetaData[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDGetMetaDataResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, serializedDdict, numManagers, errInfo='')[source]
get_sdict()[source]
builder()[source]
property serializedDdict
property numManagers
class DDManagerNodes[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDManagerNodesResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, huids, errInfo='')[source]
get_sdict()[source]
builder()[source]
property huids
class DDBPut[source]

Bases: CapNProtoMsg

__init__(tag, clientID, chkptID, respFLI, managers, batch=False)[source]
get_sdict()[source]
builder()[source]
property clientID
property chkptID
property respFLI
property managers
property batch
class DDBPutResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, numPuts, managerID)[source]
get_sdict()[source]
builder()[source]
property numPuts
property managerID
class DDPersistedChkptAvail[source]

Bases: CapNProtoMsg

__init__(tag, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property chkptID
property respFLI
class DDPersistedChkptAvailResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, available, managerID)[source]
get_sdict()[source]
builder()[source]
property available
property managerID
class DDRestore[source]

Bases: CapNProtoMsg

__init__(tag, chkptID, clientID, respFLI)[source]
get_sdict()[source]
builder()[source]
property chkptID
property clientID
property respFLI
class DDRestoreResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDAdvance[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property respFLI
class DDAdvanceResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, chkptID)[source]
get_sdict()[source]
builder()[source]
property chkptID
class DDPersistChkpts[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property respFLI
class DDPersistChkptsResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, chkptIDs)[source]
get_sdict()[source]
builder()[source]
property chkptIDs
class DDChkptAvail[source]

Bases: CapNProtoMsg

__init__(tag, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property chkptID
property respFLI
class DDChkptAvailResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, available, managerID)[source]
get_sdict()[source]
builder()[source]
property available
property managerID
class DDPersist[source]

Bases: CapNProtoMsg

__init__(tag, chkptID, respFLI)[source]
get_sdict()[source]
builder()[source]
property chkptID
property respFLI
class DDPersistResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDFreeze[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDFreezeResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDGetFreeze[source]

Bases: CapNProtoMsg

__init__(tag, clientID)[source]
get_sdict()[source]
builder()[source]
property clientID
class DDGetFreezeResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo, freeze)[source]
get_sdict()[source]
builder()[source]
property freeze
class DDUnFreeze[source]

Bases: CapNProtoMsg

__init__(tag, respFLI)[source]
get_sdict()[source]
builder()[source]
property respFLI
class DDUnFreezeResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class DDDeregisterClient[source]

Bases: CapNProtoMsg

__init__(tag, clientID, respFLI)[source]
get_sdict()[source]
builder()[source]
property clientID
property respFLI
class DDDeregisterClientResponse[source]

Bases: CapNProtoResponseMsg

__init__(tag, ref, err, errInfo='')[source]
class GSProcessCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, exe, args, env=None, rundir='', user_name='', options=None, stdin=None, stdout=None, stderr=None, group=None, user=None, umask=-1, pipesize=None, pmi=None, _pmi_info=None, layout=None, policy=None, restart=False, resilient=False, head_proc=False, _tc=None)[source]
property options
get_sdict()[source]
class GSProcessCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Process was created

FAIL = 1

Process was not created

ALREADY = 2

Process exists already

__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSProcessList[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class GSProcessListResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, plist=None, _tc=None)[source]
get_sdict()[source]
class GSProcessQuery[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, t_p_uid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSProcessQueryResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSProcessKill[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, sig, t_p_uid=None, hide_stderr=False, user_name='', _tc=None)[source]
get_sdict()[source]
class GSProcessKillResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL_KILL = 2
DEAD = 3
PENDING = 4
__init__(tag, ref, err, exit_code=0, err_info='', _tc=None)[source]
get_sdict()[source]
class GSProcessJoin[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, timeout=-1, t_p_uid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSProcessJoinResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
TIMEOUT = 2
SELF = 3
__init__(tag, ref, err, exit_code=0, err_info='', _tc=None)[source]
get_sdict()[source]
class GSProcessJoinList[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, timeout=-1, t_p_uid_list=None, user_name_list=None, join_all=False, return_on_bad_exit=False, _tc=None)[source]
get_sdict()[source]
class GSProcessJoinListResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
TIMEOUT = 2
SELF = 3
PENDING = 4
__init__(tag, ref, puid_status, _tc=None)[source]
get_sdict()[source]
class GSPoolCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, size, user_name='', options=None, _tc=None)[source]
property options
get_sdict()[source]
class GSPoolCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Pool was created

FAIL = 1

Pool was not created

ALREADY = 2

Pool exists already

__init__(tag, ref, err, err_code=0, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSPoolList[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class GSPoolListResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, mlist=None, _tc=None)[source]
get_sdict()[source]
class GSPoolQuery[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, m_uid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSPoolQueryResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSPoolDestroy[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, m_uid=0, user_name='', _tc=None)[source]
get_sdict()[source]
class GSPoolDestroyResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL = 2
GONE = 3
PENDING = 4
__init__(tag, ref, err, err_code=0, err_info='', _tc=None)[source]
get_sdict()[source]
class GSGroupCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, items=None, policy=None, user_name='', pmix_desc=None, _tc=None)[source]
get_sdict()[source]
class GSGroupCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, ref, desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupList[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class GSGroupListResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, glist=None, _tc=None)[source]
get_sdict()[source]
class GSGroupQuery[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSGroupQueryResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupKill[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, sig, g_uid=None, user_name='', hide_stderr=False, _tc=None)[source]
get_sdict()[source]
class GSGroupKillResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: IntEnum

SUCCESS = 0
UNKNOWN = 1
DEAD = 2
PENDING = 3
ALREADY = 4
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupDestroy[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSGroupDestroyResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: IntEnum

SUCCESS = 0
UNKNOWN = 1
DEAD = 3
PENDING = 4
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class RebootRuntime[source]

Bases: InfraMsg

Refer to definition and Common Fields for a description of the message structure.

__init__(tag, err_info='', h_uid=None, _tc=None)[source]
get_sdict()[source]
class GSRebootRuntime[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, r_c_uid, h_uid=None, _tc=None)[source]
get_sdict()[source]
class GSRebootRuntimeResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: IntEnum

SUCCESS = 0
UNKNOWN = 1
PENDING = 2
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
get_sdict()[source]
class GSGroupAddTo[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', items=None, _tc=None)[source]
get_sdict()[source]
class GSGroupAddToResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL = 2
DEAD = 3
PENDING = 4
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupCreateAddTo[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', items=None, policy=None, _tc=None)[source]
get_sdict()[source]
class GSGroupCreateAddToResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
DEAD = 2
PENDING = 3
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupRemoveFrom[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', items=None, _tc=None)[source]
get_sdict()[source]
class GSGroupRemoveFromResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL = 2
DEAD = 3
PENDING = 4
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSGroupDestroyRemoveFrom[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, g_uid=None, user_name='', items=None, _tc=None)[source]
get_sdict()[source]
class GSGroupDestroyRemoveFromResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL = 2
DEAD = 3
PENDING = 4
__init__(tag, ref, err, err_info='', desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSChannelCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, m_uid, options=None, user_name='', policy=None, _tc=None)[source]
get_sdict()[source]
property options
class GSChannelCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
ALREADY = 2
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSChannelList[source]

Bases: InfraMsg

Refer to to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class GSChannelListResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, clist=None, _tc=None)[source]
get_sdict()[source]
class GSChannelQuery[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid=None, user_name='', inc_refcnt=False, _tc=None)[source]
get_sdict()[source]
class GSChannelQueryResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSChannelDestroy[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid=None, user_name='', reply_req=True, dec_ref=False, _tc=None)[source]
get_sdict()[source]
class GSChannelDestroyResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
UNKNOWN_CHANNEL = 2
BUSY = 3
__init__(tag, ref, err, err_info='', _tc=None)[source]
get_sdict()[source]
class GSChannelJoin[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, name, timeout=-1, _tc=None)[source]
get_sdict()[source]
class GSChannelJoinResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
TIMEOUT = 1
DEAD = 2
__init__(tag, ref, err, desc=None, _tc=None)[source]
property desc
get_sdict()[source]
class GSChannelDetach[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid, _tc=None)[source]
get_sdict()[source]
class GSChannelDetachResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
UNKNOWN_CHANNEL = 2
NOT_ATTACHED = 3
__init__(tag, ref, err, _tc=None)[source]
get_sdict()[source]
class GSChannelGetSendH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid, _tc=None)[source]
get_sdict()[source]
class GSChannelGetSendHResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
UNKNOWN_CHANNEL = 2
NOT_ATTACHED = 3
CANT = 4
__init__(tag, ref, err, sendh=None, err_info='', _tc=None)[source]
property sendh
get_sdict()[source]
class GSChannelGetRecvH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid, _tc=None)[source]
get_sdict()[source]
class GSChannelGetRecvHResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
UNKNOWN_CHANNEL = 2
NOT_ATTACHED = 3
CANT = 4
__init__(tag, ref, err, recvh=None, err_info='', _tc=None)[source]
property recvh
get_sdict()[source]
class GSNodeList[source]

Bases: InfraMsg

type enum

GS_NODE_LIST (= 102)

purpose

Return a list of tuples of h_uid for all nodes currently registered.

fields

None additional

response

GSNodeListResponse

see also

GSNodeQuery

see also

refer to the Common Fields section for additional request message fields

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class GSNodeListResponse[source]

Bases: InfraMsg

type enum

GS_NODE_LIST_RESPONSE (= 103)

purpose

Responds with a list of h_uid for all the nodes currently registered.

fields
hlist
  • list of nonnegative integers

request

GSNodeList

see also

GSNodeQuery

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, hlist=None, _tc=None)[source]
get_sdict()[source]
class GSNodeQuery[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid: int , r_c_uid: int , name: str = '', h_uid=None, _tc=None)[source]
get_sdict()[source]
class GSNodeQueryResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
property desc
get_sdict()[source]
class GSNodeQueryAll[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid: int , r_c_uid: int , _tc=None)[source]
get_sdict()[source]
class GSNodeQueryAllResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, descriptors: List [dict | NodeDescriptor] | None = None, err_info='', _tc=None)[source]
get_sdict()[source]
class GSNodeQueryTotalCPUCount[source]

Bases: InfraMsg

type enum

GS_NODE_QUERY_TOTAL_CPU_COUNT (= 104)

purpose

Asks GS to return the total number of CPUS beloging to all of the registered nodes.

see also

refer to the Common Fields section for additional request message fields

response

GSNodeQueryTotalCPUCountResponse

__init__(tag, p_uid: int , r_c_uid: int , _tc=None)[source]
get_sdict()[source]
class GSNodeQueryTotalCPUCountResponse[source]

Bases: InfraMsg

type enum

GS_NODE_QUERY_TOTAL_CPU_COUNT_RESPONSE (= 105)

purpose

Return the total number of CPUS beloging to all of the registered nodes.

fields

Alternatives on err:

SUCCESS (= 0)

The machine descriptor was successfully constructed

total_cpus
  • total number of CPUS beloging to all of the registered nodes.

UNKNOWN ( = 1)

An unknown error has occured.

request

GSNodeQueryTotalCPUCount

see also

GSNodeQuery

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, ref, err, total_cpus=0, err_info='', _tc=None)[source]
property total_cpus
get_sdict()[source]
class AbnormalTermination[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, err_info='', host_id=0, _tc=None)[source]
get_sdict()[source]
class ExceptionlessAbort[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSStarted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSPingSH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSIsUp[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSPingProc[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, mode=None, argdata=None, _tc=None)[source]
get_sdict()[source]
class GSDumpState[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, filename, _tc=None)[source]
get_sdict()[source]
class GSHeadExit[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, exit_code=0, _tc=None)[source]
get_sdict()[source]
class GSTeardown[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSUnexpected[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, ref, _tc=None)[source]
get_sdict()[source]
class GSChannelRelease[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class GSHalted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class SHProcessCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

The initial_stdin is a string which if non-empty is written along with a terminating newline character to the stdin of the newly created process.

The stdin, stdout, and stderr are all either None or an instance of SHChannelCreate to be processed by the local services component.

__init__(tag, p_uid, r_c_uid, t_p_uid, exe, args, env=None, rundir='', options=None, initial_stdin='', stdin=None, stdout=None, stderr=None, group=None, user=None, umask=-1, pipesize=None, stdin_msg=None, stdout_msg=None, stderr_msg=None, pmi_info=None, layout=None, gs_ret_chan_msg=None, _tc=None)[source]
property options
get_sdict()[source]
class SHProcessCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', stdin_resp=None, stdout_resp=None, stderr_resp=None, gs_ret_chan_resp=None, _tc=None)[source]
get_sdict()[source]
class SHProcessKill[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, t_p_uid, sig, hide_stderr=False, _tc=None)[source]
get_sdict()[source]
class SHProcessKillResponse[source]

Bases: InfraMsg

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', _tc=None)[source]
get_sdict()[source]
class SHMultiProcessKill[source]

Bases: InfraMsg

__init__(tag, r_c_uid, procs: List [Dict | SHProcessKill], _tc=None)[source]
get_sdict()[source]
class SHMultiProcessKillResponse[source]

Bases: InfraMsg

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', exit_code=0, responses: List [Dict | SHProcessKillResponse] = None, failed: bool = False, _tc=None)[source]
get_sdict()[source]
class SHProcessExit[source]

Bases: InfraMsg

Refer to to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
__init__(tag, p_uid, creation_msg_tag=None, exit_code=0, _tc=None)[source]
get_sdict()[source]
class SHMultiProcessCreate[source]

Bases: InfraMsg

__init__(tag, r_c_uid, procs: List [Dict | SHProcessCreate], pmi_group_info: PMIGroupInfo | None = None, pmix_ddict_desc: str = None, guid: int = None, _tc=None)[source]
get_sdict()[source]
class SHMultiProcessCreateResponse[source]

Bases: InfraMsg

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', exit_code=0, responses: List [Dict | SHProcessCreateResponse] = None, failed: bool = False, _tc=None)[source]
get_sdict()[source]
class SHPoolCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, size, m_uid, name, attr='', _tc=None)[source]
get_sdict()[source]
class SHPoolCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Pool was created

FAIL = 1

Pool was not created

__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
get_sdict()[source]
class SHPoolDestroy[source]

Bases: InfraMsg

Refer to to the Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, m_uid, _tc=None)[source]
get_sdict()[source]
class SHPoolDestroyResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', _tc=None)[source]
get_sdict()[source]
class SHExecMemRequest[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class KINDS[source]

Bases: Enum

MEMORY_POOL_REQUEST = 0
MEMORY_ALLOC_REQUEST = 1
__init__(tag, p_uid, r_c_uid, kind, request, _tc=None)[source]
get_sdict()[source]
class SHExecMemResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_code=0, err_info='', response=None, _tc=None)[source]
get_sdict()[source]
class SHChannelCreate[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, m_uid, c_uid, options=None, _tc=None)[source]
get_sdict()[source]
property options
class SHChannelCreateResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, desc=None, err_info='', _tc=None)[source]
get_sdict()[source]
class SHChannelDestroy[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, c_uid, _tc=None)[source]
get_sdict()[source]
class SHChannelDestroyResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, err_info='', _tc=None)[source]
get_sdict()[source]
class SHLockChannel[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class SHLockChannelResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
ALREADY = 1
__init__(tag, ref, err, _tc=None)[source]
get_sdict()[source]
class SHAllocMsg[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class SHAllocMsgResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
__init__(tag, ref, err, _tc=None)[source]
get_sdict()[source]
class SHAllocBlock[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, r_c_uid, _tc=None)[source]
get_sdict()[source]
class SHAllocBlockResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
UNKNOWN = 1
FAIL = 2
__init__(tag, ref, err, seg_name='', offset=0, err_info='', _tc=None)[source]
get_sdict()[source]
class SHChannelsUp[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, node_desc, gs_cd, idx=0, net_conf_key=0, _tc=None)[source]
get_sdict()[source]
class SHPingGS[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, idx=0, node_sdesc=None, _tc=None)[source]
get_sdict()[source]
class SHTeardown[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class SHPingBE[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

EMPTY = ''
__init__(tag, shep_cd='', be_cd='', gs_cd='', default_pd='', inf_pd='', _tc=None)[source]
get_sdict()[source]
class SHHaltTA[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class SHHaltBE[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class SHHalted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, idx=0, _tc=None)[source]
get_sdict()[source]
class SHFwdInput[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

MAX = 1024
__init__(tag, p_uid, r_c_uid, t_p_uid=None, input='', confirm=False, _tc=None)[source]
get_sdict()[source]
class SHFwdInputErr[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, idx=0, err_info='', _tc=None)[source]
get_sdict()[source]
class SHFwdOutput[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

MAX = 1024
class FDNum[source]

Bases: Enum

STDOUT = 1
STDERR = 2
__init__(tag, p_uid, idx, fd_num, data, _tc=None, pid=-1, hostname='NONE')[source]
get_sdict()[source]
class SHDumpState[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, filename=None, _tc=None)[source]
get_sdict()[source]
class BENodeIdxSH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, node_idx, host_name=None, ip_addrs=None, primary=None, logger_sdesc=None, net_conf_key=None, _tc=None)[source]
property logger_sdesc
get_sdict()[source]
class BEPingSH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class BEHalted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class LABroadcast[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, data, _tc=None)[source]
get_sdict()[source]
class LAPassThruFB[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, c_uid, data, _tc=None)[source]
get_sdict()[source]
class LAPassThruBF[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, data, _tc=None)[source]
get_sdict()[source]
class LAServerMode[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, frontend, backend, frontend_args=None, backend_args=None, backend_env=None, backend_run_dir='', backend_user_name='', backend_options=None, _tc=None)[source]
get_sdict()[source]
class LAServerModeExit[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, _tc=None)[source]
get_sdict()[source]
class LAProcessDict[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class LAProcessDictResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

class Errors[source]

Bases: Enum

SUCCESS = 0

Always succeeds

__init__(tag, ref, err, pdict=None, _tc=None)[source]
get_sdict()[source]
class LADumpState[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, filename=None, _tc=None)[source]
get_sdict()[source]
class LAChannelsInfo[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, nodes_desc, gs_cd, num_gw_channels, port=None, transport='hsta', _tc=None, *, fe_ext_ip_addr=None)[source]
get_sdict()[source]
class LoggingMsg[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, name, msg, time, func, hostname, ip_address, port, service, level, _tc=None)[source]
get_sdict()[source]
get_logging_dict()[source]
class LoggingMsgList[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, records, _tc=None)[source]
property records
get_sdict()[source]
class LogFlushed[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class TAPingSH[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class TAHalted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class TAUp[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

The test_channels are empty unless the DRAGON_TRANSPORT_TEST environment variable is set to some value. When set in the environment, local services will create two channels and provide the base64 encoded serialized channel descriptors in this test_channels field to the launcher front end which then disseminates them to the test program which is started on each node.

__init__(tag, idx=0, test_channels=[], _tc=None)[source]
get_sdict()[source]
class Breakpoint[source]

Bases: InfraMsg

__init__(tag, p_uid, index, out_desc, in_desc, _tc=None)[source]
get_sdict()[source]
class BEIsUp[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, be_ch_desc, host_id, _tc=None)[source]
get_sdict()[source]
class FENodeIdxBE[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, node_index, net_conf_key_mapping=None, forward: dict [str , NodeDescriptor | dict ] | None = None, send_desc: B64 | str | None = None, _tc=None)[source]
property forward
property send_desc
get_sdict()[source]
class HaltLoggingInfra[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class HaltOverlay[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class OverlayHalted[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class BEHaltOverlay[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class LAHaltOverlay[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class OverlayPingBE[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class OverlayPingLA[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class LAExit[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, sigint=False, _tc=None)[source]
get_sdict()[source]
class RuntimeDesc[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, gs_cd, gs_ret_cd, ls_cd, ls_ret_cd, fe_ext_ip_addr, head_node_ip_addr, oob_port, env, _tc=None)[source]
get_sdict()[source]
class UserHaltOOB[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, _tc=None)[source]
get_sdict()[source]
class TAUpdateNodes[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, nodes: list [NodeDescriptor | dict ], _tc=None)[source]
property nodes
get_sdict()[source]
class PGRegisterClient[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, resp_cd, _tc=None)[source]
get_sdict()[source]
class PGUnregisterClient[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, p_uid, _tc=None)[source]
get_sdict()[source]
class PGClientResponse[source]

Bases: InfraMsg

Refer to Common Fields for a description of the message structure.

__init__(tag, src_tag, error=None, ex=None, payload=None, _tc=None)[source]
get_sdict()[source]
class PGSetProperties[source]

Bases: InfraMsg

__init__(tag, p_uid, props, _tc=None)[source]
get_sdict()[source]
class PGStopRestart[source]

Bases: InfraMsg

__init__(tag, p_uid, _tc=None)[source]
get_sdict()[source]
class PGAddProcessTemplates[source]

Bases: InfraMsg

__init__(tag, p_uid, templates, _tc=None)[source]
get_sdict()[source]
class PGStart[source]

Bases: InfraMsg

__init__(tag, p_uid, _tc=None)[source]
get_sdict()[source]
class PGJoin[source]

Bases: InfraMsg

__init__(tag, p_uid, timeout, _tc=None)[source]
get_sdict()[source]
class PGSignal[source]

Bases: InfraMsg

__init__(tag, p_uid, sig, hide_stderr, _tc=None)[source]
get_sdict()[source]
class PGState[source]

Bases: InfraMsg

__init__(tag, p_uid, _tc=None)[source]
get_sdict()[source]
class PGStop[source]

Bases: InfraMsg

__init__(tag, p_uid, patience, _tc=None)[source]
get_sdict()[source]
class PGPuids[source]

Bases: InfraMsg

__init__(tag, p_uid, active=True, inactive=False, _tc=None)[source]
get_sdict()[source]
class PGClose[source]

Bases: InfraMsg

__init__(tag, p_uid, patience, _tc=None)[source]
get_sdict()[source]
class PMIxFenceMsg[source]

Bases: CapNProtoMsg

__init__(tag, ndata, data)[source]
get_sdict()[source]
builder()[source]
class GSGroupDestroyPMIx[source]

Bases: InfraMsg

__init__(tag, r_c_uid, guid=None, user_name='', _tc=None)[source]
get_sdict()[source]
class GSGroupDestroyPMIxResponse[source]

Bases: InfraMsg

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1
__init__(tag, ref, err, guid=None, user_name='', err_info='', _tc=None)[source]
get_sdict()[source]
class LSDestroyPMIx[source]

Bases: InfraMsg

__init__(tag, r_c_uid, guid, _tc=None)[source]
get_sdict()[source]
class LSDestroyPMIxResponse[source]

Bases: InfraMsg

class Errors[source]

Bases: Enum

SUCCESS = 0
FAIL = 1

PMIx resources assigned to group not found or already destroyed

__init__(tag, ref, err, guid=None, user_name='', err_info='', _tc=None)[source]
get_sdict()[source]
type_filter(the_msg_types)[source]
camel_case_msg_name(msg_id)[source]
mk_all_message_classes_set()[source]
parse(serialized, restrict=None)[source]