2 % * Copyright (c) 2010, Oracle America, Inc.
4 % * Redistribution and use in source and binary forms, with or without
5 % * modification, are permitted provided that the following conditions are
8 % * * Redistributions of source code must retain the above copyright
9 % * notice, this list of conditions and the following disclaimer.
10 % * * Redistributions in binary form must reproduce the above
11 % * copyright notice, this list of conditions and the following
12 % * disclaimer in the documentation and/or other materials
13 % * provided with the distribution.
14 % * * Neither the name of the "Oracle America, Inc." nor the names of its
15 % * contributors may be used to endorse or promote products derived
16 % * from this software without specific prior written permission.
18 % * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
19 % * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
20 % * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
21 % * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
22 % * COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT,
23 % * INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
24 % * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE
25 % * GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
26 % * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
27 % * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
28 % * NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
29 % * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
32 * Key server protocol definition
33 * Copyright (C) 1990, 1991 Sun Microsystems, Inc.
35 * The keyserver is a public key storage/encryption/decryption service
36 * The encryption method used is based on the Diffie-Hellman exponential
37 * key exchange technology.
39 * The key server is local to each machine, akin to the portmapper.
40 * Under TI-RPC, communication with the keyserver is through the
43 * NOTE: This .x file generates the USER level headers for the keyserver.
44 * the KERNEL level headers are created by hand as they kernel has special
49 % * Compiled from key_prot.x using rpcgen.
50 % * DO NOT EDIT THIS FILE!
51 % * This is NOT source code!
55 * PROOT and MODULUS define the way the Diffie-Hellman key is generated.
57 * MODULUS should be chosen as a prime of the form: MODULUS == 2*p + 1,
58 * where p is also prime.
60 * PROOT satisfies the following two conditions:
61 * (1) (PROOT ** 2) % MODULUS != 1
62 * (2) (PROOT ** p) % MODULUS != 1
67 const HEXMODULUS = "d4a0ba0250b6fd2ec626e7efd637df76c716e22d0944b88b";
69 const HEXKEYBYTES = 48; /* HEXKEYBYTES == strlen(HEXMODULUS) */
70 const KEYSIZE = 192; /* KEYSIZE == bit length of key */
71 const KEYBYTES = 24; /* byte length of key */
74 * The first 16 hex digits of the encrypted secret key are used as
75 * a checksum in the database.
77 const KEYCHECKSUMSIZE = 16;
83 KEY_SUCCESS, /* no problems */
84 KEY_NOSECRET, /* no secret key stored */
85 KEY_UNKNOWN, /* unknown netname */
86 KEY_SYSTEMERR /* system error (out of memory, encryption failure) */
89 typedef opaque keybuf[HEXKEYBYTES]; /* store key in hex */
91 typedef string netnamestr<MAXNETNAMELEN>;
94 * Argument to ENCRYPT or DECRYPT
97 netnamestr remotename;
102 * Argument to ENCRYPT_PK or DECRYPT_PK
104 struct cryptkeyarg2 {
105 netnamestr remotename;
106 netobj remotekey; /* Contains a length up to 1024 bytes */
112 * Result of ENCRYPT, DECRYPT, ENCRYPT_PK, and DECRYPT_PK
114 union cryptkeyres switch (keystatus status) {
121 const MAXGIDS = 16; /* max number of gids in gid list */
133 * Result returned from GETCRED
135 union getcredres switch (keystatus status) {
145 struct key_netstarg {
148 netnamestr st_netname;
151 union key_netstres switch (keystatus status){
169 * This is my secret key.
176 * I want to talk to X.
177 * Encrypt a conversation key for me.
180 KEY_ENCRYPT(cryptkeyarg) = 2;
183 * X just sent me a message.
184 * Decrypt the conversation key for me.
187 KEY_DECRYPT(cryptkeyarg) = 3;
190 * Generate a secure conversation key for me
196 * Get me the uid, gid and group-access-list associated
197 * with this netname (for kernel which cannot use NIS)
200 KEY_GETCRED(netnamestr) = 5;
206 * Procedures 1-5 are identical to version 1
211 * This is my secret key.
218 * I want to talk to X.
219 * Encrypt a conversation key for me.
222 KEY_ENCRYPT(cryptkeyarg) = 2;
225 * X just sent me a message.
226 * Decrypt the conversation key for me.
229 KEY_DECRYPT(cryptkeyarg) = 3;
232 * Generate a secure conversation key for me
238 * Get me the uid, gid and group-access-list associated
239 * with this netname (for kernel which cannot use NIS)
242 KEY_GETCRED(netnamestr) = 5;
245 * I want to talk to X. and I know X's public key
246 * Encrypt a conversation key for me.
249 KEY_ENCRYPT_PK(cryptkeyarg2) = 6;
252 * X just sent me a message. and I know X's public key
253 * Decrypt the conversation key for me.
256 KEY_DECRYPT_PK(cryptkeyarg2) = 7;
259 * Store my public key, netname and private key.
262 KEY_NET_PUT(key_netstarg) = 8;
265 * Retrieve my public key, netname and private key.
268 KEY_NET_GET(void) = 9;
271 * Return me the conversation key that is constructed
272 * from my secret key and this publickey.
276 KEY_GET_CONV(keybuf) = 10;