trcs

Documentation

Overview

Package trcs defines the commands to generate base TRC and TRC updates from the configuration files.

Index

• Variables
• func AllPartsFiles(dir string, isd addr.ISD, ver scrypto.Version) string
• func Dir(dir string, isd addr.ISD) string
• func PartsDir(dir string, isd addr.ISD, ver scrypto.Version) string
• func PartsFile(dir string, ia addr.IA, ver scrypto.Version) string
• func ProtoFile(dir string, isd addr.ISD, ver scrypto.Version) string
• func SignedFile(dir string, isd addr.ISD, ver scrypto.Version) string

Variables

var Cmd = &cobra.Command{
	Use:   "trcs",
	Short: "Generate TRCs for the SCION control plane PKI",
	Long: `'trc' can be used to generate Trust Root Configuration (TRC) files used in the
SCION control plane PKI.

Generating a TRC can be split into three phases:
1. 'proto': Generate the prototype TRC that contains the payload part of the signed TRC.
2. 'sign': Sign the payload with the respective private keys.
3. 'combine': Combine the signatures and the payload to a fully signed TRC.

In case the caller has access to all private keys, the caller can use a
short-cut command that generates the signed TRC in one call: 'gen'.

Selector:
    *: All ISDs under the root directory.
    X: ISD X.

The subcommands expect the contents of the root directory to follow a predefined
file structure. See 'scion-pki help' for more information.
`,
}

Functions

func AllPartsFiles

func AllPartsFiles(dir string, isd addr.ISD, ver scrypto.Version) string

AllPartsFiles returns a glob string that matches all TRC parts for the given ISD and version.

func Dir

func Dir(dir string, isd addr.ISD) string

Dir returns the directory where TRCs are written to.

func PartsDir

func PartsDir(dir string, isd addr.ISD, ver scrypto.Version) string

PartsDir returns the directory where the partially signed TRC is written to.

func PartsFile

func PartsFile(dir string, ia addr.IA, ver scrypto.Version) string

PartsFile returns the file path for the partially signed TRC for a given AS.

func ProtoFile

func ProtoFile(dir string, isd addr.ISD, ver scrypto.Version) string

ProtoFile returns the file path for the prototype TRC.

func SignedFile

func SignedFile(dir string, isd addr.ISD, ver scrypto.Version) string

SignedFile returns the file path for the signed TRC.