hammer2 - spanning tree and messaging work
[dragonfly.git] / sbin / hammer2 / hammer2.h
... / ...
CommitLineData
1/*
2 * Copyright (c) 2011-2012 The DragonFly Project. All rights reserved.
3 *
4 * This code is derived from software contributed to The DragonFly Project
5 * by Matthew Dillon <dillon@dragonflybsd.org>
6 * by Venkatesh Srinivas <vsrinivas@dragonflybsd.org>
7 *
8 * Redistribution and use in source and binary forms, with or without
9 * modification, are permitted provided that the following conditions
10 * are met:
11 *
12 * 1. Redistributions of source code must retain the above copyright
13 * notice, this list of conditions and the following disclaimer.
14 * 2. Redistributions in binary form must reproduce the above copyright
15 * notice, this list of conditions and the following disclaimer in
16 * the documentation and/or other materials provided with the
17 * distribution.
18 * 3. Neither the name of The DragonFly Project nor the names of its
19 * contributors may be used to endorse or promote products derived
20 * from this software without specific, prior written permission.
21 *
22 * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
23 * ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
24 * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
25 * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
26 * COPYRIGHT HOLDERS OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
27 * INCIDENTAL, SPECIAL, EXEMPLARY OR CONSEQUENTIAL DAMAGES (INCLUDING,
28 * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES;
29 * LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
30 * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
31 * OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT
32 * OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
33 * SUCH DAMAGE.
34 */
35
36/*
37 * Rollup headers for hammer2 utility
38 */
39#include <sys/types.h>
40#include <sys/uio.h>
41#include <sys/mount.h>
42#include <sys/file.h>
43#include <sys/socket.h>
44#include <sys/time.h>
45#include <sys/wait.h>
46#include <sys/tty.h>
47#include <sys/endian.h>
48
49#include <netinet/in.h>
50#include <netinet/tcp.h>
51#include <arpa/inet.h>
52#include <netdb.h>
53
54#include <vfs/hammer2/hammer2_disk.h>
55#include <vfs/hammer2/hammer2_mount.h>
56#include <vfs/hammer2/hammer2_ioctl.h>
57#include <vfs/hammer2/hammer2_network.h>
58
59#include <stdio.h>
60#include <stdlib.h>
61#include <stdarg.h>
62#include <stddef.h>
63
64#include <errno.h>
65#include <fcntl.h>
66#include <signal.h>
67#include <string.h>
68#include <unistd.h>
69#include <ctype.h>
70#include <uuid.h>
71#include <assert.h>
72#include <pthread.h>
73#include <poll.h>
74
75#include <libutil.h>
76
77#include "network.h"
78
79#define HAMMER2_DEFAULT_DIR "/etc/hammer2"
80#define HAMMER2_PATH_REMOTE HAMMER2_DEFAULT_DIR "/remote"
81
82struct hammer2_idmap {
83 struct hammer2_idmap *next;
84 uint32_t ran_beg; /* inclusive */
85 uint32_t ran_end; /* inclusive */
86};
87
88typedef struct hammer2_idmap hammer2_idmap_t;
89
90extern int DebugOpt;
91extern int VerboseOpt;
92extern int QuietOpt;
93extern int NormalExit;
94
95/*
96 * Hammer2 command APIs
97 */
98int hammer2_ioctl_handle(const char *sel_path);
99void hammer2_demon(void *(*func)(void *), void *arg);
100
101int cmd_remote_connect(const char *sel_path, const char *url);
102int cmd_remote_disconnect(const char *sel_path, const char *url);
103int cmd_remote_status(const char *sel_path, int all_opt);
104
105int cmd_pfs_getid(const char *sel_path, const char *name, int privateid);
106int cmd_pfs_list(const char *sel_path);
107int cmd_pfs_create(const char *sel_path, const char *name,
108 uint8_t pfs_type, const char *uuid_str);
109int cmd_pfs_delete(const char *sel_path, const char *name);
110
111int cmd_service(void);
112int cmd_stat(int ac, const char **av);
113int cmd_leaf(const char *sel_path);
114int cmd_shell(const char *hostname);
115int cmd_show(const char *devpath);
116int cmd_rsainit(const char *dir_path);
117int cmd_rsaenc(const char **keys, int nkeys);
118int cmd_rsadec(const char **keys, int nkeys);
119
120/*
121 * Msg support functions
122 */
123void hammer2_bswap_head(hammer2_msg_hdr_t *head);
124void hammer2_ioq_init(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq);
125void hammer2_ioq_done(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq);
126void hammer2_iocom_init(hammer2_iocom_t *iocom, int sock_fd, int alt_fd);
127void hammer2_iocom_done(hammer2_iocom_t *iocom);
128hammer2_msg_t *hammer2_msg_alloc(hammer2_iocom_t *iocom, size_t aux_size,
129 uint32_t cmd);
130void hammer2_msg_reply(hammer2_iocom_t *iocom, hammer2_msg_t *msg,
131 uint32_t error);
132void hammer2_msg_result(hammer2_iocom_t *iocom, hammer2_msg_t *msg,
133 uint32_t error);
134void hammer2_state_reply(hammer2_state_t *state, uint32_t error);
135
136void hammer2_msg_free(hammer2_iocom_t *iocom, hammer2_msg_t *msg);
137
138void hammer2_iocom_core(hammer2_iocom_t *iocom,
139 void (*iocom_recvmsg)(hammer2_iocom_t *),
140 void (*iocom_sendmsg)(hammer2_iocom_t *),
141 void (*iocom_altmsg)(hammer2_iocom_t *));
142hammer2_msg_t *hammer2_ioq_read(hammer2_iocom_t *iocom);
143void hammer2_msg_write(hammer2_iocom_t *iocom, hammer2_msg_t *msg,
144 void (*func)(hammer2_state_t *, hammer2_msg_t *),
145 void *data, hammer2_state_t **statep);
146
147void hammer2_iocom_drain(hammer2_iocom_t *iocom);
148void hammer2_iocom_flush1(hammer2_iocom_t *iocom);
149void hammer2_iocom_flush2(hammer2_iocom_t *iocom);
150
151void hammer2_state_cleanuprx(hammer2_iocom_t *iocom, hammer2_msg_t *msg);
152void hammer2_state_free(hammer2_state_t *state);
153
154/*
155 * Msg protocol functions
156 */
157void hammer2_msg_lnk(hammer2_iocom_t *iocom, hammer2_msg_t *msg);
158void hammer2_msg_dbg(hammer2_iocom_t *iocom, hammer2_msg_t *msg);
159
160/*
161 * Crypto functions
162 */
163void hammer2_crypto_negotiate(hammer2_iocom_t *iocom);
164void hammer2_crypto_decrypt(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq);
165void hammer2_crypto_decrypt_aux(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq,
166 hammer2_msg_t *msg, int already);
167int hammer2_crypto_encrypt(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq,
168 struct iovec *iov, int n);
169void hammer2_crypto_encrypt_wrote(hammer2_iocom_t *iocom, hammer2_ioq_t *ioq,
170 int nact);
171
172/*
173 * Misc functions
174 */
175const char *hammer2_time64_to_str(uint64_t htime64, char **strp);
176const char *hammer2_uuid_to_str(uuid_t *uuid, char **strp);
177const char *hammer2_iptype_to_str(uint8_t type);
178const char *hammer2_pfstype_to_str(uint8_t type);
179const char *sizetostr(hammer2_off_t size);
180
181void hammer2_msg_debug(hammer2_iocom_t *iocom, hammer2_msg_t *msg);
182void iocom_printf(hammer2_iocom_t *iocom, uint32_t cmd, const char *ctl, ...);
183void *hammer2_alloc(size_t bytes);
184void hammer2_free(void *ptr);