libczmq-dev 4.1.0-2 / usr / share / zproject / czmq / zcert.api

This file is indexed.

/usr/share/zproject/czmq/zcert.api is in libczmq-dev 4.1.0-2.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below. 

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
<class name = "zcert" state = "stable">
    <!--
    Copyright (c) the Contributors as noted in the AUTHORS file.
    This file is part of CZMQ, the high-level C binding for 0MQ:
    http://czmq.zeromq.org.

    This Source Code Form is subject to the terms of the Mozilla Public
    License, v. 2.0. If a copy of the MPL was not distributed with this
    file, You can obtain one at http://mozilla.org/MPL/2.0/.
    -->
    work with CURVE security certificates

    <constructor>
        Create and initialize a new certificate in memory
    </constructor>

    <constructor name = "new from">
        Accepts public/secret key pair from caller
        <argument name = "public key" type = "buffer" />
        <argument name = "secret key" type = "buffer" />
    </constructor>

    <constructor name = "new from txt" state = "draft">
        Accepts public/secret key text pair from caller
        <argument name = "public txt" type = "string" />
        <argument name = "secret txt" type = "string" />
    </constructor>

    <constructor name = "load">
        Load certificate from file
        <argument name = "filename" type = "string" />
    </constructor>

    <destructor>
        Destroy a certificate in memory
    </destructor>

    <method name = "public key">
        Return public part of key pair as 32-byte binary string
        <return type = "buffer" size = "32" />
    </method>

    <method name = "secret key">
        Return secret part of key pair as 32-byte binary string
        <return type = "buffer" size = "32" />
    </method>

    <method name = "public txt">
        Return public part of key pair as Z85 armored string
        <return type = "string" />
    </method>

    <method name = "secret txt">
        Return secret part of key pair as Z85 armored string
        <return type = "string" />
    </method>

    <method name = "set meta">
        Set certificate metadata from formatted string.
        <argument name = "name" type = "string" />
        <argument name = "format" type = "format" />
    </method>

    <method name = "unset meta" state = "draft" >
        Unset certificate metadata.
        <argument name = "name" type = "string" />
    </method>

    <method name = "meta">
        Get metadata value from certificate; if the metadata value doesn't
        exist, returns NULL.
        <argument name = "name" type = "string" />
        <return type = "string" />
    </method>

    <method name = "meta keys">
        Get list of metadata fields from certificate. Caller is responsible for
        destroying list. Caller should not modify the values of list items.
        <return type = "zlist" />
    </method>

    <method name = "save">
        Save full certificate (public + secret) to file for persistent storage
        This creates one public file and one secret file (filename + "_secret").
        <argument name = "filename" type = "string" />
        <return type = "integer" />
    </method>

    <method name = "save public">
        Save public certificate only to file for persistent storage
        <argument name = "filename" type = "string" />
        <return type = "integer" />
    </method>

    <method name = "save secret">
        Save secret certificate only to file for persistent storage
        <argument name = "filename" type = "string" />
        <return type = "integer" />
    </method>

    <method name = "apply">
        Apply certificate to socket, i.e. use for CURVE security on socket.
        If certificate was loaded from public file, the secret key will be
        undefined, and this certificate will not work successfully.
        <argument name = "socket" type = "sockish" />
    </method>

    <method name = "dup">
        Return copy of certificate; if certificate is NULL or we exhausted
        heap memory, returns NULL.
        <return type = "zcert" fresh = "1" />
    </method>

    <method name = "eq">
        Return true if two certificates have the same keys
        <argument name = "compare" type = "zcert" />
        <return type = "boolean" />
    </method>

    <method name = "print">
        Print certificate contents to stdout
    </method>

    <method name = "test" singleton = "1">
        Self test of this class
        <argument name = "verbose" type = "boolean" />
    </method>
</class>

APT Browse - Built by Thomas Orozco.