rpcinterface_3dde7c30165d11d1ab8f00805f14db40_1_0

import "github.com/TheManticoreProject/Manticore/network/dcerpc/interfaces/3dde7c30-165d-11d1-ab8f-00805f14db40/1.0"

Package rpcinterface_3dde7c30165d11d1ab8f00805f14db40_1_0 is the descriptor for the BackupKey RPC interface, abstract syntax 3dde7c30-165d-11d1-ab8f-00805f14db40 version 1.0 ([MS-BKRP]).

Generated by tools/idlgen (descriptor phase) from the IDL, then reviewed: the PipeName, the status-code table, and doc comments are not derivable from the IDL and must be confirmed by hand (see the TODO markers).

Index

• Constants
• Variables
• func StatusString(status uint32) string
• func SyntaxID() syntax.SyntaxID

Constants

PipeName is the IPC$-relative named pipe for the BackupKey interface. Per [MS-BKRP] section 2.1 (Transport), the server listens on \pipe\protected_storage (preferred) and MAY also listen on \pipe\ntsvcs; a client attempts protected_storage first and falls back to ntsvcs.

const (
    PipeName         = `\protected_storage`
    PipeNameFallback = `\ntsvcs`
)

Status codes returned by the BackuprKey method ([MS-BKRP] section 3.1.4.1). The method returns a NET_API_STATUS: 0 (ERROR_SUCCESS) on success, a nonzero Win32 error otherwise. The spec names ERROR_INVALID_PARAMETER for an unsupported pguidActionAgent; all other nonzero codes are opaque Win32 errors the client treats identically.

const (
    ErrorSuccess          uint32 = 0x00000000
    ErrorInvalidParameter uint32 = 0x00000057
)

Opnums for the on-the-wire methods.

const (
    OpnumBackuprKey uint16 = 0
)

Variables

Well-known action-agent GUIDs passed in the BackuprKey pguidActionAgent parameter ([MS-BKRP] section 3.1.4.1). BACKUPKEY_BACKUP_GUID / BACKUPKEY_RESTORE_GUID_WIN2K select the ServerWrap subprotocol; BACKUPKEY_RETRIEVE_BACKUP_KEY_GUID / BACKUPKEY_RESTORE_GUID select the ClientWrap subprotocol.

var (
    // BackupKeyBackupGUID (7F752B10-178E-11D1-AB8F-00805F14DB40) requests server-side wrapping.
    BackupKeyBackupGUID = guid.GUID{A: 0x7f752b10, B: 0x178e, C: 0x11d1, D: 0xab8f, E: 0x00805f14db40}
    // BackupKeyRestoreGUIDWin2K (7FE94D50-178E-11D1-AB8F-00805F14DB40) requests unwrapping of a server-side-wrapped secret.
    BackupKeyRestoreGUIDWin2K = guid.GUID{A: 0x7fe94d50, B: 0x178e, C: 0x11d1, D: 0xab8f, E: 0x00805f14db40}
    // BackupKeyRetrieveBackupKeyGUID (018FF48A-EABA-40C6-8F6D-72370240E967) requests the server's ClientWrap public key.
    BackupKeyRetrieveBackupKeyGUID = guid.GUID{A: 0x018ff48a, B: 0xeaba, C: 0x40c6, D: 0x8f6d, E: 0x72370240e967}
    // BackupKeyRestoreGUID (47270C64-2FC7-499B-AC5B-0E37CDCE899A) requests unwrapping of a client-side-wrapped secret.
    BackupKeyRestoreGUID = guid.GUID{A: 0x47270c64, B: 0x2fc7, C: 0x499b, D: 0xac5b, E: 0x0e37cdce899a}
)

NameToOpnum is the reverse of OpnumToName, built at init so the two never drift.

var NameToOpnum = func() map[string]uint16 {
    m := make(map[string]uint16, len(OpnumToName))
    for op, name := range OpnumToName {
        m[name] = op
    }
    return m
}()

OpnumToName maps each on-the-wire opnum to its method name; the single source of truth.

var OpnumToName = map[uint16]string{
    OpnumBackuprKey: "BackuprKey",
}

func StatusString

func StatusString(status uint32) string

StatusString returns a mnemonic for the documented status codes, otherwise the hex value.

func SyntaxID

func SyntaxID() syntax.SyntaxID

SyntaxID returns the BackupKey abstract syntax identifier: 3dde7c30-165d-11d1-ab8f-00805f14db40, version 1.0.