2 * In-kernel MOUNT protocol client
4 * Copyright (C) 1997, Olaf Kirch <okir@monad.swb.de>
7 #include <linux/types.h>
8 #include <linux/socket.h>
9 #include <linux/kernel.h>
10 #include <linux/errno.h>
11 #include <linux/uio.h>
12 #include <linux/net.h>
14 #include <linux/sunrpc/clnt.h>
15 #include <linux/sunrpc/sched.h>
16 #include <linux/nfs_fs.h>
20 # define NFSDBG_FACILITY NFSDBG_MOUNT
24 * Defined by RFC 1094, section A.3; and RFC 1813, section 5.1.4
26 #define MNTPATHLEN (1024)
31 #define encode_dirpath_sz (1 + XDR_QUADLEN(MNTPATHLEN))
32 #define MNT_status_sz (1)
33 #define MNT_fhs_status_sz (1)
34 #define MNT_fhandle_sz XDR_QUADLEN(NFS2_FHSIZE)
35 #define MNT_fhandle3_sz (1 + XDR_QUADLEN(NFS3_FHSIZE))
36 #define MNT_authflav3_sz (1 + NFS_MAX_SECFLAVORS)
39 * XDR argument and result sizes
41 #define MNT_enc_dirpath_sz encode_dirpath_sz
42 #define MNT_dec_mountres_sz (MNT_status_sz + MNT_fhandle_sz)
43 #define MNT_dec_mountres3_sz (MNT_status_sz + MNT_fhandle_sz + \
47 * Defined by RFC 1094, section A.5
54 MOUNTPROC_UMNTALL = 4,
59 * Defined by RFC 1813, section 5.2
66 MOUNTPROC3_UMNTALL = 4,
67 MOUNTPROC3_EXPORT = 5,
70 static struct rpc_program mnt_program;
73 * Defined by OpenGroup XNFS Version 3W, chapter 8
87 { .status = MNT_OK, .errno = 0, },
88 { .status = MNT_EPERM, .errno = -EPERM, },
89 { .status = MNT_ENOENT, .errno = -ENOENT, },
90 { .status = MNT_EACCES, .errno = -EACCES, },
91 { .status = MNT_EINVAL, .errno = -EINVAL, },
95 * Defined by RFC 1813, section 5.1.5
98 MNT3_OK = 0, /* no error */
99 MNT3ERR_PERM = 1, /* Not owner */
100 MNT3ERR_NOENT = 2, /* No such file or directory */
101 MNT3ERR_IO = 5, /* I/O error */
102 MNT3ERR_ACCES = 13, /* Permission denied */
103 MNT3ERR_NOTDIR = 20, /* Not a directory */
104 MNT3ERR_INVAL = 22, /* Invalid argument */
105 MNT3ERR_NAMETOOLONG = 63, /* Filename too long */
106 MNT3ERR_NOTSUPP = 10004, /* Operation not supported */
107 MNT3ERR_SERVERFAULT = 10006, /* A failure on the server */
114 { .status = MNT3_OK, .errno = 0, },
115 { .status = MNT3ERR_PERM, .errno = -EPERM, },
116 { .status = MNT3ERR_NOENT, .errno = -ENOENT, },
117 { .status = MNT3ERR_IO, .errno = -EIO, },
118 { .status = MNT3ERR_ACCES, .errno = -EACCES, },
119 { .status = MNT3ERR_NOTDIR, .errno = -ENOTDIR, },
120 { .status = MNT3ERR_INVAL, .errno = -EINVAL, },
121 { .status = MNT3ERR_NAMETOOLONG, .errno = -ENAMETOOLONG, },
122 { .status = MNT3ERR_NOTSUPP, .errno = -ENOTSUPP, },
123 { .status = MNT3ERR_SERVERFAULT, .errno = -EREMOTEIO, },
129 unsigned int *auth_count;
130 rpc_authflavor_t *auth_flavors;
133 struct mnt_fhstatus {
139 * nfs_mount - Obtain an NFS file handle for the given host and path
140 * @info: pointer to mount request arguments
142 * Uses default timeout parameters specified by underlying transport.
144 int nfs_mount(struct nfs_mount_request *info)
146 struct mountres result = {
148 .auth_count = info->auth_flav_len,
149 .auth_flavors = info->auth_flavs,
151 struct rpc_message msg = {
152 .rpc_argp = info->dirpath,
155 struct rpc_create_args args = {
157 .protocol = info->protocol,
158 .address = info->sap,
159 .addrsize = info->salen,
160 .servername = info->hostname,
161 .program = &mnt_program,
162 .version = info->version,
163 .authflavor = RPC_AUTH_UNIX,
165 struct rpc_clnt *mnt_clnt;
168 dprintk("NFS: sending MNT request for %s:%s\n",
169 (info->hostname ? info->hostname : "server"),
172 if (info->noresvport)
173 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
175 mnt_clnt = rpc_create(&args);
176 if (IS_ERR(mnt_clnt))
179 if (info->version == NFS_MNT3_VERSION)
180 msg.rpc_proc = &mnt_clnt->cl_procinfo[MOUNTPROC3_MNT];
182 msg.rpc_proc = &mnt_clnt->cl_procinfo[MOUNTPROC_MNT];
184 status = rpc_call_sync(mnt_clnt, &msg, 0);
185 rpc_shutdown_client(mnt_clnt);
189 if (result.errno != 0)
192 dprintk("NFS: MNT request succeeded\n");
199 status = PTR_ERR(mnt_clnt);
200 dprintk("NFS: failed to create MNT RPC client, status=%d\n", status);
204 dprintk("NFS: MNT request failed, status=%d\n", status);
208 dprintk("NFS: MNT server returned result %d\n", result.errno);
209 status = result.errno;
214 * nfs_umount - Notify a server that we have unmounted this export
215 * @info: pointer to umount request arguments
217 * MOUNTPROC_UMNT is advisory, so we set a short timeout, and always
220 void nfs_umount(const struct nfs_mount_request *info)
222 static const struct rpc_timeout nfs_umnt_timeout = {
223 .to_initval = 1 * HZ,
227 struct rpc_create_args args = {
229 .protocol = IPPROTO_UDP,
230 .address = info->sap,
231 .addrsize = info->salen,
232 .timeout = &nfs_umnt_timeout,
233 .servername = info->hostname,
234 .program = &mnt_program,
235 .version = info->version,
236 .authflavor = RPC_AUTH_UNIX,
237 .flags = RPC_CLNT_CREATE_NOPING,
239 struct rpc_message msg = {
240 .rpc_argp = info->dirpath,
242 struct rpc_clnt *clnt;
245 if (info->noresvport)
246 args.flags |= RPC_CLNT_CREATE_NONPRIVPORT;
248 clnt = rpc_create(&args);
249 if (unlikely(IS_ERR(clnt)))
252 dprintk("NFS: sending UMNT request for %s:%s\n",
253 (info->hostname ? info->hostname : "server"), info->dirpath);
255 if (info->version == NFS_MNT3_VERSION)
256 msg.rpc_proc = &clnt->cl_procinfo[MOUNTPROC3_UMNT];
258 msg.rpc_proc = &clnt->cl_procinfo[MOUNTPROC_UMNT];
260 status = rpc_call_sync(clnt, &msg, 0);
261 rpc_shutdown_client(clnt);
263 if (unlikely(status < 0))
269 dprintk("NFS: failed to create UMNT RPC client, status=%ld\n",
274 dprintk("NFS: UMNT request failed, status=%d\n", status);
278 * XDR encode/decode functions for MOUNT
281 static void encode_mntdirpath(struct xdr_stream *xdr, const char *pathname)
283 const u32 pathname_len = strlen(pathname);
286 BUG_ON(pathname_len > MNTPATHLEN);
287 p = xdr_reserve_space(xdr, 4 + pathname_len);
288 xdr_encode_opaque(p, pathname, pathname_len);
291 static int mnt_enc_dirpath(struct rpc_rqst *req, __be32 *p,
294 struct xdr_stream xdr;
296 xdr_init_encode(&xdr, &req->rq_snd_buf, p);
297 encode_mntdirpath(&xdr, dirpath);
302 * RFC 1094: "A non-zero status indicates some sort of error. In this
303 * case, the status is a UNIX error number." This can be problematic
304 * if the server and client use different errno values for the same
307 * However, the OpenGroup XNFS spec provides a simple mapping that is
308 * independent of local errno values on the server and the client.
310 static int decode_status(struct xdr_stream *xdr, struct mountres *res)
316 p = xdr_inline_decode(xdr, 4);
317 if (unlikely(p == NULL))
319 status = be32_to_cpup(p);
321 for (i = 0; i < ARRAY_SIZE(mnt_errtbl); i++) {
322 if (mnt_errtbl[i].status == status) {
323 res->errno = mnt_errtbl[i].errno;
328 dprintk("NFS: unrecognized MNT status code: %u\n", status);
329 res->errno = -EACCES;
333 static int decode_fhandle(struct xdr_stream *xdr, struct mountres *res)
335 struct nfs_fh *fh = res->fh;
338 p = xdr_inline_decode(xdr, NFS2_FHSIZE);
339 if (unlikely(p == NULL))
342 fh->size = NFS2_FHSIZE;
343 memcpy(fh->data, p, NFS2_FHSIZE);
347 static int mnt_dec_mountres(struct rpc_rqst *req, __be32 *p,
348 struct mountres *res)
350 struct xdr_stream xdr;
353 xdr_init_decode(&xdr, &req->rq_rcv_buf, p);
355 status = decode_status(&xdr, res);
356 if (unlikely(status != 0 || res->errno != 0))
358 return decode_fhandle(&xdr, res);
361 static int decode_fhs_status(struct xdr_stream *xdr, struct mountres *res)
367 p = xdr_inline_decode(xdr, 4);
368 if (unlikely(p == NULL))
370 status = be32_to_cpup(p);
372 for (i = 0; i < ARRAY_SIZE(mnt3_errtbl); i++) {
373 if (mnt3_errtbl[i].status == status) {
374 res->errno = mnt3_errtbl[i].errno;
379 dprintk("NFS: unrecognized MNT3 status code: %u\n", status);
380 res->errno = -EACCES;
384 static int decode_fhandle3(struct xdr_stream *xdr, struct mountres *res)
386 struct nfs_fh *fh = res->fh;
390 p = xdr_inline_decode(xdr, 4);
391 if (unlikely(p == NULL))
394 size = be32_to_cpup(p);
395 if (size > NFS3_FHSIZE || size == 0)
398 p = xdr_inline_decode(xdr, size);
399 if (unlikely(p == NULL))
403 memcpy(fh->data, p, size);
407 static int decode_auth_flavors(struct xdr_stream *xdr, struct mountres *res)
409 rpc_authflavor_t *flavors = res->auth_flavors;
410 unsigned int *count = res->auth_count;
417 p = xdr_inline_decode(xdr, 4);
418 if (unlikely(p == NULL))
420 entries = be32_to_cpup(p);
421 dprintk("NFS: received %u auth flavors\n", entries);
422 if (entries > NFS_MAX_SECFLAVORS)
423 entries = NFS_MAX_SECFLAVORS;
425 p = xdr_inline_decode(xdr, 4 * entries);
426 if (unlikely(p == NULL))
429 if (entries > *count)
432 for (i = 0; i < entries; i++) {
433 flavors[i] = be32_to_cpup(p++);
434 dprintk("NFS: auth flavor[%u]: %d\n", i, flavors[i]);
441 static int mnt_dec_mountres3(struct rpc_rqst *req, __be32 *p,
442 struct mountres *res)
444 struct xdr_stream xdr;
447 xdr_init_decode(&xdr, &req->rq_rcv_buf, p);
449 status = decode_fhs_status(&xdr, res);
450 if (unlikely(status != 0 || res->errno != 0))
452 status = decode_fhandle3(&xdr, res);
453 if (unlikely(status != 0)) {
454 res->errno = -EBADHANDLE;
457 return decode_auth_flavors(&xdr, res);
460 static struct rpc_procinfo mnt_procedures[] = {
462 .p_proc = MOUNTPROC_MNT,
463 .p_encode = (kxdrproc_t)mnt_enc_dirpath,
464 .p_decode = (kxdrproc_t)mnt_dec_mountres,
465 .p_arglen = MNT_enc_dirpath_sz,
466 .p_replen = MNT_dec_mountres_sz,
467 .p_statidx = MOUNTPROC_MNT,
471 .p_proc = MOUNTPROC_UMNT,
472 .p_encode = (kxdrproc_t)mnt_enc_dirpath,
473 .p_arglen = MNT_enc_dirpath_sz,
474 .p_statidx = MOUNTPROC_UMNT,
479 static struct rpc_procinfo mnt3_procedures[] = {
481 .p_proc = MOUNTPROC3_MNT,
482 .p_encode = (kxdrproc_t)mnt_enc_dirpath,
483 .p_decode = (kxdrproc_t)mnt_dec_mountres3,
484 .p_arglen = MNT_enc_dirpath_sz,
485 .p_replen = MNT_dec_mountres3_sz,
486 .p_statidx = MOUNTPROC3_MNT,
489 [MOUNTPROC3_UMNT] = {
490 .p_proc = MOUNTPROC3_UMNT,
491 .p_encode = (kxdrproc_t)mnt_enc_dirpath,
492 .p_arglen = MNT_enc_dirpath_sz,
493 .p_statidx = MOUNTPROC3_UMNT,
499 static struct rpc_version mnt_version1 = {
501 .nrprocs = ARRAY_SIZE(mnt_procedures),
502 .procs = mnt_procedures,
505 static struct rpc_version mnt_version3 = {
507 .nrprocs = ARRAY_SIZE(mnt3_procedures),
508 .procs = mnt3_procedures,
511 static struct rpc_version *mnt_version[] = {
518 static struct rpc_stat mnt_stats;
520 static struct rpc_program mnt_program = {
522 .number = NFS_MNT_PROGRAM,
523 .nrvers = ARRAY_SIZE(mnt_version),
524 .version = mnt_version,