psshfs.h revision 1.35 1 /* $NetBSD: psshfs.h,v 1.35 2009/02/23 18:43:46 pooka Exp $ */
2
3 /*
4 * Copyright (c) 2006, 2007 Antti Kantee. All Rights Reserved.
5 *
6 * Redistribution and use in source and binary forms, with or without
7 * modification, are permitted provided that the following conditions
8 * are met:
9 * 1. Redistributions of source code must retain the above copyright
10 * notice, this list of conditions and the following disclaimer.
11 * 2. Redistributions in binary form must reproduce the above copyright
12 * notice, this list of conditions and the following disclaimer in the
13 * documentation and/or other materials provided with the distribution.
14 *
15 * THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS
16 * OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED
17 * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
18 * DISCLAIMED. IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
19 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
20 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
21 * SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
22 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
23 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
24 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
25 * SUCH DAMAGE.
26 */
27
28 #ifndef PSSHFS_H_
29 #define PSSHFS_H_
30
31 #include <sys/queue.h>
32
33 #include <puffs.h>
34
35 extern unsigned int max_reads;
36
37 /*
38 * Later protocol versions would have some advantages (such as link count
39 * supported directly as a part of stat), but since proto version 3 seems
40 * to be the only widely available version, let's not try to jump through
41 * too many hoops to be compatible with all versions.
42 */
43 #define SFTP_PROTOVERSION 3
44
45 /* extensions, held in psshfs_ctx extensions */
46 #define SFTP_EXT_POSIX_RENAME 0x01
47 #define SFTP_EXT_STATVFS 0x02
48 #define SFTP_EXT_FSTATVFS 0x04
49
50 #define DEFAULTREFRESH 30
51 #define REFRESHTIMEOUT(pctx, t) \
52 (!(pctx)->refreshival || ((pctx->refreshival!=-1) && ((t)>pctx->refreshival)))
53
54 PUFFSOP_PROTOS(psshfs);
55
56 #define NEXTREQ(pctx) ((pctx->nextreq)++)
57 #define PSSHFSAUTOVAR(pu) \
58 struct puffs_cc *pcc = puffs_cc_getcc(pu); \
59 struct psshfs_ctx *pctx = puffs_getspecific(pu); \
60 uint32_t reqid = NEXTREQ(pctx); \
61 struct puffs_framebuf *pb = psbuf_makeout(); \
62 int rv = 0
63
64 #define PSSHFSRETURN(rv) \
65 puffs_framebuf_destroy(pb); \
66 return (rv)
67
68 #define GETRESPONSE(pb) \
69 do { \
70 if (puffs_framev_enqueue_cc(pcc, pctx->sshfd, pb, 0) == -1) { \
71 rv = errno; \
72 goto out; \
73 } \
74 } while (/*CONSTCOND*/0)
75
76 #define JUSTSEND(pb) \
77 do { \
78 if (puffs_framev_enqueue_justsend(pu,pctx->sshfd,pb,1,0) == -1){\
79 rv = errno; \
80 goto out; \
81 } \
82 } while (/*CONSTCOND*/0)
83
84 #define SENDCB(pb, f, a) \
85 do { \
86 if (puffs_framev_enqueue_cb(pu, pctx->sshfd, pb,f,a,0) == -1) { \
87 rv = errno; \
88 goto out; \
89 } \
90 } while (/*CONSTCOND*/0)
91
92 struct psshfs_dir {
93 int valid;
94 struct puffs_node *entry;
95
96 char *entryname;
97 struct vattr va;
98 time_t attrread;
99 };
100
101 struct psshfs_fid {
102 time_t mounttime;
103 struct puffs_node *node;
104 };
105
106 struct psshfs_wait {
107 struct puffs_cc *pw_cc;
108 int pw_type;
109 TAILQ_ENTRY(psshfs_wait) pw_entries;
110 };
111 #define PWTYPE_READDIR 1
112 #define PWTYPE_READ1 2
113 #define PWTYPE_READ2 3
114 #define PWTYPE_WRITE 4
115
116 struct psshfs_node {
117 struct puffs_node *parent;
118
119 struct psshfs_dir *dir; /* only valid if we're of type VDIR */
120
121 size_t denttot;
122 size_t dentnext;
123 time_t dentread;
124 int childcount;
125
126 int stat;
127 int readcount;
128
129 time_t attrread;
130 char *symlink;
131 time_t slread;
132
133 char *fhand_r;
134 char *fhand_w;
135 uint32_t fhand_r_len;
136 uint32_t fhand_w_len;
137 struct puffs_framebuf *lazyopen_r;
138 struct puffs_framebuf *lazyopen_w;
139 int lazyopen_err_r, lazyopen_err_w;
140
141 TAILQ_HEAD(, psshfs_wait) pw;
142 };
143 #define PSN_RECLAIMED 0x01
144 #define PSN_HASFH 0x02
145 #define PSN_READDIR 0x04
146 #define PSN_DOLAZY_R 0x08
147 #define PSN_DOLAZY_W 0x10
148 #define PSN_LAZYWAIT_R 0x20
149 #define PSN_LAZYWAIT_W 0x40
150 #define PSN_HANDLECLOSE 0x80
151
152 #define HANDLE_READ 0x1
153 #define HANDLE_WRITE 0x2
154
155 struct psshfs_ctx {
156 int sshfd;
157 pid_t sshpid;
158 const char *mountpath;
159 char **sshargs;
160
161 int protover;
162 int extensions;
163
164 uint32_t nextreq;
165
166 struct puffs_framebuf *curpb;
167
168 struct psshfs_node psn_root;
169 ino_t nextino;
170
171 int canexport;
172 time_t mounttime;
173
174 int refreshival;
175 };
176
177 int psshfs_handshake(struct puffs_usermount *);
178
179 int psbuf_read(struct puffs_usermount *, struct puffs_framebuf *,int,int*);
180 int psbuf_write(struct puffs_usermount *, struct puffs_framebuf *,int,int*);
181 int psbuf_cmp(struct puffs_usermount *,
182 struct puffs_framebuf *, struct puffs_framebuf *, int *);
183
184 struct puffs_framebuf *psbuf_makeout(void);
185 void psbuf_recycleout(struct puffs_framebuf *);
186
187 void psbuf_put_1(struct puffs_framebuf *, uint8_t);
188 void psbuf_put_2(struct puffs_framebuf *, uint16_t);
189 void psbuf_put_4(struct puffs_framebuf *, uint32_t);
190 void psbuf_put_8(struct puffs_framebuf *, uint64_t);
191 void psbuf_put_str(struct puffs_framebuf *, const char *);
192 void psbuf_put_data(struct puffs_framebuf *, const void *, uint32_t);
193 void psbuf_put_vattr(struct puffs_framebuf *, const struct vattr *);
194
195 uint8_t psbuf_get_type(struct puffs_framebuf *);
196 uint32_t psbuf_get_len(struct puffs_framebuf *);
197 uint32_t psbuf_get_reqid(struct puffs_framebuf *);
198
199 int psbuf_get_1(struct puffs_framebuf *, uint8_t *);
200 int psbuf_get_2(struct puffs_framebuf *, uint16_t *);
201 int psbuf_get_4(struct puffs_framebuf *, uint32_t *);
202 int psbuf_get_8(struct puffs_framebuf *, uint64_t *);
203 int psbuf_get_str(struct puffs_framebuf *, char **, uint32_t *);
204 int psbuf_get_vattr(struct puffs_framebuf *, struct vattr *);
205
206 int psbuf_expect_status(struct puffs_framebuf *);
207 int psbuf_expect_handle(struct puffs_framebuf *, char **, uint32_t *);
208 int psbuf_expect_name(struct puffs_framebuf *, uint32_t *);
209 int psbuf_expect_attrs(struct puffs_framebuf *, struct vattr *);
210
211 int psbuf_do_data(struct puffs_framebuf *, uint8_t *, uint32_t *);
212
213 void psbuf_req_data(struct puffs_framebuf *, int, uint32_t,
214 const void *, uint32_t);
215 void psbuf_req_str(struct puffs_framebuf *, int, uint32_t, const char *);
216
217 int sftp_readdir(struct puffs_usermount *, struct psshfs_ctx *,
218 struct puffs_node *);
219
220 struct psshfs_dir *lookup(struct psshfs_dir *, size_t, const char *);
221 struct puffs_node *makenode(struct puffs_usermount *, struct puffs_node *,
222 struct psshfs_dir *, const struct vattr *);
223 struct puffs_node *allocnode(struct puffs_usermount *, struct puffs_node *,
224 const char *, const struct vattr *);
225 struct psshfs_dir *direnter(struct puffs_node *, const char *);
226 void nukenode(struct puffs_node *, const char *, int);
227 void doreclaim(struct puffs_node *);
228 int getpathattr(struct puffs_usermount *, const char *, struct vattr *);
229 int getnodeattr(struct puffs_usermount *, struct puffs_node *);
230
231 void closehandles(struct puffs_usermount *, struct psshfs_node *, int);
232 void lazyopen_rresp(struct puffs_usermount *, struct puffs_framebuf *,
233 void *, int);
234 void lazyopen_wresp(struct puffs_usermount *, struct puffs_framebuf *,
235 void *, int);
236
237 #endif /* PSSHFS_H_ */
238