xref: /freebsd/include/rpcsvc/bootparam_prot.x (revision 732a02b4e77866604a120a275c082bb6221bd2ff)
1 /*-
2  * Copyright (c) 2010, Oracle America, Inc.
3  *
4  * Redistribution and use in source and binary forms, with or without
5  * modification, are permitted provided that the following conditions are
6  * met:
7  *
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.
17  *
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.
30  */
31 
32 /*
33  * RPC for bootparms service.
34  * There are two procedures:
35  *   WHOAMI takes a net address and returns a client name and also a
36  *	likely net address for routing
37  *   GETFILE takes a client name and file identifier and returns the
38  *	server name, server net address and pathname for the file.
39  *   file identifiers typically include root, swap, pub and dump
40  */
41 
42 #ifdef RPC_HDR
43 %#include <rpc/types.h>
44 %#include <sys/time.h>
45 %#include <sys/errno.h>
46 %#include <sys/param.h>
47 %#include <sys/syslimits.h>
48 #else
49 %#ifndef lint
50 %/*static char sccsid[] = "from: @(#)bootparam_prot.x 1.2 87/06/24 Copyr 1987 Sun Micro";*/
51 %/*static char sccsid[] = "from: @(#)bootparam_prot.x	2.1 88/08/01 4.0 RPCSRC";*/
52 %#endif /* not lint */
53 %#include <sys/cdefs.h>
54 %__FBSDID("$FreeBSD$");
55 #endif
56 
57 const MAX_MACHINE_NAME  = 255;
58 const MAX_PATH_LEN	= 1024;
59 const MAX_FILEID	= 32;
60 const IP_ADDR_TYPE	= 1;
61 
62 typedef	string	bp_machine_name_t<MAX_MACHINE_NAME>;
63 typedef	string	bp_path_t<MAX_PATH_LEN>;
64 typedef	string	bp_fileid_t<MAX_FILEID>;
65 
66 struct	ip_addr_t {
67 	char	net;
68 	char	host;
69 	char	lh;
70 	char	impno;
71 };
72 
73 union bp_address switch (int address_type) {
74 	case IP_ADDR_TYPE:
75 		ip_addr_t	ip_addr;
76 };
77 
78 struct bp_whoami_arg {
79 	bp_address		client_address;
80 };
81 
82 struct bp_whoami_res {
83 	bp_machine_name_t	client_name;
84 	bp_machine_name_t	domain_name;
85 	bp_address		router_address;
86 };
87 
88 struct bp_getfile_arg {
89 	bp_machine_name_t	client_name;
90 	bp_fileid_t		file_id;
91 };
92 
93 struct bp_getfile_res {
94 	bp_machine_name_t	server_name;
95 	bp_address		server_address;
96 	bp_path_t		server_path;
97 };
98 
99 program BOOTPARAMPROG {
100 	version BOOTPARAMVERS {
101 		bp_whoami_res	BOOTPARAMPROC_WHOAMI(bp_whoami_arg) = 1;
102 		bp_getfile_res	BOOTPARAMPROC_GETFILE(bp_getfile_arg) = 2;
103 	} = 1;
104 } = 100026;
105