rpc_pipe.c 28.4 KB
Newer Older
L
Linus Torvalds 已提交
1 2 3 4 5
/*
 * net/sunrpc/rpc_pipe.c
 *
 * Userland/kernel interface for rpcauth_gss.
 * Code shamelessly plagiarized from fs/nfsd/nfsctl.c
6
 * and fs/sysfs/inode.c
L
Linus Torvalds 已提交
7 8 9 10 11 12 13 14 15 16
 *
 * Copyright (c) 2002, Trond Myklebust <trond.myklebust@fys.uio.no>
 *
 */
#include <linux/module.h>
#include <linux/slab.h>
#include <linux/string.h>
#include <linux/pagemap.h>
#include <linux/mount.h>
#include <linux/namei.h>
17
#include <linux/fsnotify.h>
L
Linus Torvalds 已提交
18 19 20 21 22 23 24 25 26 27
#include <linux/kernel.h>

#include <asm/ioctls.h>
#include <linux/poll.h>
#include <linux/wait.h>
#include <linux/seq_file.h>

#include <linux/sunrpc/clnt.h>
#include <linux/workqueue.h>
#include <linux/sunrpc/rpc_pipe_fs.h>
28
#include <linux/sunrpc/cache.h>
29
#include <linux/nsproxy.h>
30
#include <linux/notifier.h>
31 32

#include "netns.h"
33
#include "sunrpc.h"
L
Linus Torvalds 已提交
34

35 36 37 38
#define RPCDBG_FACILITY RPCDBG_DEBUG

#define NET_NAME(net)	((net == &init_net) ? " (init_net)" : "")

L
Linus Torvalds 已提交
39 40 41
static struct file_system_type rpc_pipe_fs_type;


42
static struct kmem_cache *rpc_inode_cachep __read_mostly;
L
Linus Torvalds 已提交
43 44 45

#define RPC_UPCALL_TIMEOUT (30*HZ)

46 47 48 49 50 51 52 53 54 55 56 57 58 59
static BLOCKING_NOTIFIER_HEAD(rpc_pipefs_notifier_list);

int rpc_pipefs_notifier_register(struct notifier_block *nb)
{
	return blocking_notifier_chain_cond_register(&rpc_pipefs_notifier_list, nb);
}
EXPORT_SYMBOL_GPL(rpc_pipefs_notifier_register);

void rpc_pipefs_notifier_unregister(struct notifier_block *nb)
{
	blocking_notifier_chain_unregister(&rpc_pipefs_notifier_list, nb);
}
EXPORT_SYMBOL_GPL(rpc_pipefs_notifier_unregister);

60
static void rpc_purge_list(wait_queue_head_t *waitq, struct list_head *head,
61
		void (*destroy_msg)(struct rpc_pipe_msg *), int err)
L
Linus Torvalds 已提交
62 63 64
{
	struct rpc_pipe_msg *msg;

65 66 67
	if (list_empty(head))
		return;
	do {
68
		msg = list_entry(head->next, struct rpc_pipe_msg, list);
69
		list_del_init(&msg->list);
L
Linus Torvalds 已提交
70
		msg->errno = err;
71
		destroy_msg(msg);
72
	} while (!list_empty(head));
73
	wake_up(waitq);
L
Linus Torvalds 已提交
74 75 76
}

static void
77
rpc_timeout_upcall_queue(struct work_struct *work)
L
Linus Torvalds 已提交
78
{
79
	LIST_HEAD(free_list);
80 81
	struct rpc_pipe *pipe =
		container_of(work, struct rpc_pipe, queue_timeout.work);
82
	void (*destroy_msg)(struct rpc_pipe_msg *);
83
	struct dentry *dentry;
L
Linus Torvalds 已提交
84

85 86 87 88 89
	spin_lock(&pipe->lock);
	destroy_msg = pipe->ops->destroy_msg;
	if (pipe->nreaders == 0) {
		list_splice_init(&pipe->pipe, &free_list);
		pipe->pipelen = 0;
90
	}
91
	dentry = dget(pipe->dentry);
92
	spin_unlock(&pipe->lock);
93 94 95 96 97
	if (dentry) {
		rpc_purge_list(&RPC_I(dentry->d_inode)->waitq,
			       &free_list, destroy_msg, -ETIMEDOUT);
		dput(dentry);
	}
L
Linus Torvalds 已提交
98 99
}

100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119
ssize_t rpc_pipe_generic_upcall(struct file *filp, struct rpc_pipe_msg *msg,
				char __user *dst, size_t buflen)
{
	char *data = (char *)msg->data + msg->copied;
	size_t mlen = min(msg->len - msg->copied, buflen);
	unsigned long left;

	left = copy_to_user(dst, data, mlen);
	if (left == mlen) {
		msg->errno = -EFAULT;
		return -EFAULT;
	}

	mlen -= left;
	msg->copied += mlen;
	msg->errno = 0;
	return mlen;
}
EXPORT_SYMBOL_GPL(rpc_pipe_generic_upcall);

120
/**
121
 * rpc_queue_upcall - queue an upcall message to userspace
122 123 124 125 126 127 128 129
 * @inode: inode of upcall pipe on which to queue given message
 * @msg: message to queue
 *
 * Call with an @inode created by rpc_mkpipe() to queue an upcall.
 * A userspace process may then later read the upcall by performing a
 * read on an open file for this inode.  It is up to the caller to
 * initialize the fields of @msg (other than @msg->list) appropriately.
 */
L
Linus Torvalds 已提交
130
int
131
rpc_queue_upcall(struct rpc_pipe *pipe, struct rpc_pipe_msg *msg)
L
Linus Torvalds 已提交
132
{
133
	int res = -EPIPE;
134
	struct dentry *dentry;
L
Linus Torvalds 已提交
135

136 137 138 139
	spin_lock(&pipe->lock);
	if (pipe->nreaders) {
		list_add_tail(&msg->list, &pipe->pipe);
		pipe->pipelen += msg->len;
140
		res = 0;
141 142
	} else if (pipe->flags & RPC_PIPE_WAIT_FOR_OPEN) {
		if (list_empty(&pipe->pipe))
143
			queue_delayed_work(rpciod_workqueue,
144
					&pipe->queue_timeout,
L
Linus Torvalds 已提交
145
					RPC_UPCALL_TIMEOUT);
146 147
		list_add_tail(&msg->list, &pipe->pipe);
		pipe->pipelen += msg->len;
148 149
		res = 0;
	}
150
	dentry = dget(pipe->dentry);
151
	spin_unlock(&pipe->lock);
152 153 154 155
	if (dentry) {
		wake_up(&RPC_I(dentry->d_inode)->waitq);
		dput(dentry);
	}
L
Linus Torvalds 已提交
156 157
	return res;
}
158
EXPORT_SYMBOL_GPL(rpc_queue_upcall);
L
Linus Torvalds 已提交
159

160 161 162 163 164 165
static inline void
rpc_inode_setowner(struct inode *inode, void *private)
{
	RPC_I(inode)->private = private;
}

L
Linus Torvalds 已提交
166 167 168
static void
rpc_close_pipes(struct inode *inode)
{
169
	struct rpc_pipe *pipe = RPC_I(inode)->pipe;
170
	int need_release;
171
	LIST_HEAD(free_list);
L
Linus Torvalds 已提交
172

173
	mutex_lock(&inode->i_mutex);
174 175 176 177 178 179 180 181
	spin_lock(&pipe->lock);
	need_release = pipe->nreaders != 0 || pipe->nwriters != 0;
	pipe->nreaders = 0;
	list_splice_init(&pipe->in_upcall, &free_list);
	list_splice_init(&pipe->pipe, &free_list);
	pipe->pipelen = 0;
	pipe->dentry = NULL;
	spin_unlock(&pipe->lock);
182
	rpc_purge_list(&RPC_I(inode)->waitq, &free_list, pipe->ops->destroy_msg, -EPIPE);
183 184 185 186
	pipe->nwriters = 0;
	if (need_release && pipe->ops->release_pipe)
		pipe->ops->release_pipe(inode);
	cancel_delayed_work_sync(&pipe->queue_timeout);
187
	rpc_inode_setowner(inode, NULL);
188
	RPC_I(inode)->pipe = NULL;
189
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
190 191 192 193 194 195
}

static struct inode *
rpc_alloc_inode(struct super_block *sb)
{
	struct rpc_inode *rpci;
196
	rpci = (struct rpc_inode *)kmem_cache_alloc(rpc_inode_cachep, GFP_KERNEL);
L
Linus Torvalds 已提交
197 198 199 200 201 202
	if (!rpci)
		return NULL;
	return &rpci->vfs_inode;
}

static void
N
Nick Piggin 已提交
203
rpc_i_callback(struct rcu_head *head)
L
Linus Torvalds 已提交
204
{
N
Nick Piggin 已提交
205
	struct inode *inode = container_of(head, struct inode, i_rcu);
L
Linus Torvalds 已提交
206 207 208
	kmem_cache_free(rpc_inode_cachep, RPC_I(inode));
}

N
Nick Piggin 已提交
209 210 211 212 213 214
static void
rpc_destroy_inode(struct inode *inode)
{
	call_rcu(&inode->i_rcu, rpc_i_callback);
}

L
Linus Torvalds 已提交
215 216 217
static int
rpc_pipe_open(struct inode *inode, struct file *filp)
{
218
	struct rpc_pipe *pipe;
219
	int first_open;
L
Linus Torvalds 已提交
220 221
	int res = -ENXIO;

222
	mutex_lock(&inode->i_mutex);
223 224
	pipe = RPC_I(inode)->pipe;
	if (pipe == NULL)
225
		goto out;
226 227 228
	first_open = pipe->nreaders == 0 && pipe->nwriters == 0;
	if (first_open && pipe->ops->open_pipe) {
		res = pipe->ops->open_pipe(inode);
229 230
		if (res)
			goto out;
L
Linus Torvalds 已提交
231
	}
232
	if (filp->f_mode & FMODE_READ)
233
		pipe->nreaders++;
234
	if (filp->f_mode & FMODE_WRITE)
235
		pipe->nwriters++;
236 237
	res = 0;
out:
238
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
239 240 241 242 243 244
	return res;
}

static int
rpc_pipe_release(struct inode *inode, struct file *filp)
{
245
	struct rpc_pipe *pipe;
L
Linus Torvalds 已提交
246
	struct rpc_pipe_msg *msg;
247
	int last_close;
L
Linus Torvalds 已提交
248

249
	mutex_lock(&inode->i_mutex);
250 251
	pipe = RPC_I(inode)->pipe;
	if (pipe == NULL)
L
Linus Torvalds 已提交
252
		goto out;
253
	msg = filp->private_data;
L
Linus Torvalds 已提交
254
	if (msg != NULL) {
255
		spin_lock(&pipe->lock);
256
		msg->errno = -EAGAIN;
257
		list_del_init(&msg->list);
258 259
		spin_unlock(&pipe->lock);
		pipe->ops->destroy_msg(msg);
L
Linus Torvalds 已提交
260 261
	}
	if (filp->f_mode & FMODE_WRITE)
262
		pipe->nwriters --;
263
	if (filp->f_mode & FMODE_READ) {
264 265
		pipe->nreaders --;
		if (pipe->nreaders == 0) {
266
			LIST_HEAD(free_list);
267 268 269 270
			spin_lock(&pipe->lock);
			list_splice_init(&pipe->pipe, &free_list);
			pipe->pipelen = 0;
			spin_unlock(&pipe->lock);
271
			rpc_purge_list(&RPC_I(inode)->waitq, &free_list,
272
					pipe->ops->destroy_msg, -EAGAIN);
273 274
		}
	}
275 276 277
	last_close = pipe->nwriters == 0 && pipe->nreaders == 0;
	if (last_close && pipe->ops->release_pipe)
		pipe->ops->release_pipe(inode);
L
Linus Torvalds 已提交
278
out:
279
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
280 281 282 283 284 285
	return 0;
}

static ssize_t
rpc_pipe_read(struct file *filp, char __user *buf, size_t len, loff_t *offset)
{
J
Josef Sipek 已提交
286
	struct inode *inode = filp->f_path.dentry->d_inode;
287
	struct rpc_pipe *pipe;
L
Linus Torvalds 已提交
288 289 290
	struct rpc_pipe_msg *msg;
	int res = 0;

291
	mutex_lock(&inode->i_mutex);
292 293
	pipe = RPC_I(inode)->pipe;
	if (pipe == NULL) {
L
Linus Torvalds 已提交
294 295 296 297 298
		res = -EPIPE;
		goto out_unlock;
	}
	msg = filp->private_data;
	if (msg == NULL) {
299 300 301
		spin_lock(&pipe->lock);
		if (!list_empty(&pipe->pipe)) {
			msg = list_entry(pipe->pipe.next,
L
Linus Torvalds 已提交
302 303
					struct rpc_pipe_msg,
					list);
304 305
			list_move(&msg->list, &pipe->in_upcall);
			pipe->pipelen -= msg->len;
L
Linus Torvalds 已提交
306 307 308
			filp->private_data = msg;
			msg->copied = 0;
		}
309
		spin_unlock(&pipe->lock);
L
Linus Torvalds 已提交
310 311 312 313
		if (msg == NULL)
			goto out_unlock;
	}
	/* NOTE: it is up to the callback to update msg->copied */
314
	res = pipe->ops->upcall(filp, msg, buf, len);
L
Linus Torvalds 已提交
315 316
	if (res < 0 || msg->len == msg->copied) {
		filp->private_data = NULL;
317
		spin_lock(&pipe->lock);
318
		list_del_init(&msg->list);
319 320
		spin_unlock(&pipe->lock);
		pipe->ops->destroy_msg(msg);
L
Linus Torvalds 已提交
321 322
	}
out_unlock:
323
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
324 325 326 327 328 329
	return res;
}

static ssize_t
rpc_pipe_write(struct file *filp, const char __user *buf, size_t len, loff_t *offset)
{
J
Josef Sipek 已提交
330
	struct inode *inode = filp->f_path.dentry->d_inode;
L
Linus Torvalds 已提交
331 332
	int res;

333
	mutex_lock(&inode->i_mutex);
L
Linus Torvalds 已提交
334
	res = -EPIPE;
335 336
	if (RPC_I(inode)->pipe != NULL)
		res = RPC_I(inode)->pipe->ops->downcall(filp, buf, len);
337
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
338 339 340 341 342 343
	return res;
}

static unsigned int
rpc_pipe_poll(struct file *filp, struct poll_table_struct *wait)
{
344 345 346
	struct inode *inode = filp->f_path.dentry->d_inode;
	struct rpc_inode *rpci = RPC_I(inode);
	unsigned int mask = POLLOUT | POLLWRNORM;
L
Linus Torvalds 已提交
347

348
	poll_wait(filp, &rpci->waitq, wait);
L
Linus Torvalds 已提交
349

350 351
	mutex_lock(&inode->i_mutex);
	if (rpci->pipe == NULL)
L
Linus Torvalds 已提交
352
		mask |= POLLERR | POLLHUP;
353
	else if (filp->private_data || !list_empty(&rpci->pipe->pipe))
L
Linus Torvalds 已提交
354
		mask |= POLLIN | POLLRDNORM;
355
	mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
356 357 358
	return mask;
}

A
Arnd Bergmann 已提交
359 360
static long
rpc_pipe_ioctl(struct file *filp, unsigned int cmd, unsigned long arg)
L
Linus Torvalds 已提交
361
{
A
Arnd Bergmann 已提交
362
	struct inode *inode = filp->f_path.dentry->d_inode;
363
	struct rpc_pipe *pipe;
L
Linus Torvalds 已提交
364 365 366 367
	int len;

	switch (cmd) {
	case FIONREAD:
368 369 370 371
		mutex_lock(&inode->i_mutex);
		pipe = RPC_I(inode)->pipe;
		if (pipe == NULL) {
			mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
372
			return -EPIPE;
A
Arnd Bergmann 已提交
373
		}
374
		spin_lock(&pipe->lock);
375
		len = pipe->pipelen;
L
Linus Torvalds 已提交
376 377
		if (filp->private_data) {
			struct rpc_pipe_msg *msg;
378
			msg = filp->private_data;
L
Linus Torvalds 已提交
379 380
			len += msg->len - msg->copied;
		}
381
		spin_unlock(&pipe->lock);
382
		mutex_unlock(&inode->i_mutex);
L
Linus Torvalds 已提交
383 384 385 386 387 388
		return put_user(len, (int __user *)arg);
	default:
		return -EINVAL;
	}
}

389
static const struct file_operations rpc_pipe_fops = {
L
Linus Torvalds 已提交
390 391 392 393 394
	.owner		= THIS_MODULE,
	.llseek		= no_llseek,
	.read		= rpc_pipe_read,
	.write		= rpc_pipe_write,
	.poll		= rpc_pipe_poll,
395
	.unlocked_ioctl	= rpc_pipe_ioctl,
L
Linus Torvalds 已提交
396 397 398 399 400 401 402 403 404 405 406 407
	.open		= rpc_pipe_open,
	.release	= rpc_pipe_release,
};

static int
rpc_show_info(struct seq_file *m, void *v)
{
	struct rpc_clnt *clnt = m->private;

	seq_printf(m, "RPC server: %s\n", clnt->cl_server);
	seq_printf(m, "service: %s (%d) version %d\n", clnt->cl_protname,
			clnt->cl_prog, clnt->cl_vers);
408 409
	seq_printf(m, "address: %s\n", rpc_peeraddr2str(clnt, RPC_DISPLAY_ADDR));
	seq_printf(m, "protocol: %s\n", rpc_peeraddr2str(clnt, RPC_DISPLAY_PROTO));
410
	seq_printf(m, "port: %s\n", rpc_peeraddr2str(clnt, RPC_DISPLAY_PORT));
L
Linus Torvalds 已提交
411 412 413 414 415 416
	return 0;
}

static int
rpc_info_open(struct inode *inode, struct file *file)
{
417
	struct rpc_clnt *clnt = NULL;
L
Linus Torvalds 已提交
418 419 420 421
	int ret = single_open(file, rpc_show_info, NULL);

	if (!ret) {
		struct seq_file *m = file->private_data;
422 423 424 425 426 427

		spin_lock(&file->f_path.dentry->d_lock);
		if (!d_unhashed(file->f_path.dentry))
			clnt = RPC_I(inode)->private;
		if (clnt != NULL && atomic_inc_not_zero(&clnt->cl_count)) {
			spin_unlock(&file->f_path.dentry->d_lock);
L
Linus Torvalds 已提交
428 429
			m->private = clnt;
		} else {
430
			spin_unlock(&file->f_path.dentry->d_lock);
L
Linus Torvalds 已提交
431 432 433 434 435 436 437 438 439 440 441 442 443 444 445 446 447 448
			single_release(inode, file);
			ret = -EINVAL;
		}
	}
	return ret;
}

static int
rpc_info_release(struct inode *inode, struct file *file)
{
	struct seq_file *m = file->private_data;
	struct rpc_clnt *clnt = (struct rpc_clnt *)m->private;

	if (clnt)
		rpc_release_client(clnt);
	return single_release(inode, file);
}

449
static const struct file_operations rpc_info_operations = {
L
Linus Torvalds 已提交
450 451 452 453 454 455 456 457 458 459 460 461
	.owner		= THIS_MODULE,
	.open		= rpc_info_open,
	.read		= seq_read,
	.llseek		= seq_lseek,
	.release	= rpc_info_release,
};


/*
 * Description of fs contents.
 */
struct rpc_filelist {
462
	const char *name;
463
	const struct file_operations *i_fop;
464
	umode_t mode;
L
Linus Torvalds 已提交
465 466
};

N
Nick Piggin 已提交
467
static int rpc_delete_dentry(const struct dentry *dentry)
T
Trond Myklebust 已提交
468 469 470 471
{
	return 1;
}

A
Al Viro 已提交
472
static const struct dentry_operations rpc_dentry_operations = {
T
Trond Myklebust 已提交
473 474 475
	.d_delete = rpc_delete_dentry,
};

L
Linus Torvalds 已提交
476
static struct inode *
477
rpc_get_inode(struct super_block *sb, umode_t mode)
L
Linus Torvalds 已提交
478 479 480 481
{
	struct inode *inode = new_inode(sb);
	if (!inode)
		return NULL;
482
	inode->i_ino = get_next_ino();
L
Linus Torvalds 已提交
483 484
	inode->i_mode = mode;
	inode->i_atime = inode->i_mtime = inode->i_ctime = CURRENT_TIME;
J
Joe Perches 已提交
485 486 487 488 489 490 491
	switch (mode & S_IFMT) {
	case S_IFDIR:
		inode->i_fop = &simple_dir_operations;
		inode->i_op = &simple_dir_inode_operations;
		inc_nlink(inode);
	default:
		break;
L
Linus Torvalds 已提交
492 493 494 495
	}
	return inode;
}

496 497 498 499 500 501 502
static int __rpc_create_common(struct inode *dir, struct dentry *dentry,
			       umode_t mode,
			       const struct file_operations *i_fop,
			       void *private)
{
	struct inode *inode;

T
Trond Myklebust 已提交
503
	d_drop(dentry);
504 505 506 507 508 509 510 511 512 513 514 515 516 517 518 519 520
	inode = rpc_get_inode(dir->i_sb, mode);
	if (!inode)
		goto out_err;
	inode->i_ino = iunique(dir->i_sb, 100);
	if (i_fop)
		inode->i_fop = i_fop;
	if (private)
		rpc_inode_setowner(inode, private);
	d_add(dentry, inode);
	return 0;
out_err:
	printk(KERN_WARNING "%s: %s failed to allocate inode for dentry %s\n",
			__FILE__, __func__, dentry->d_name.name);
	dput(dentry);
	return -ENOMEM;
}

521 522 523 524 525 526 527 528 529 530 531 532 533 534
static int __rpc_create(struct inode *dir, struct dentry *dentry,
			umode_t mode,
			const struct file_operations *i_fop,
			void *private)
{
	int err;

	err = __rpc_create_common(dir, dentry, S_IFREG | mode, i_fop, private);
	if (err)
		return err;
	fsnotify_create(dir, dentry);
	return 0;
}

535 536 537 538 539 540 541 542 543 544 545 546 547 548 549
static int __rpc_mkdir(struct inode *dir, struct dentry *dentry,
		       umode_t mode,
		       const struct file_operations *i_fop,
		       void *private)
{
	int err;

	err = __rpc_create_common(dir, dentry, S_IFDIR | mode, i_fop, private);
	if (err)
		return err;
	inc_nlink(dir);
	fsnotify_mkdir(dir, dentry);
	return 0;
}

550 551 552 553 554 555 556 557 558 559 560 561 562
static void
init_pipe(struct rpc_pipe *pipe)
{
	pipe->nreaders = 0;
	pipe->nwriters = 0;
	INIT_LIST_HEAD(&pipe->in_upcall);
	INIT_LIST_HEAD(&pipe->in_downcall);
	INIT_LIST_HEAD(&pipe->pipe);
	pipe->pipelen = 0;
	INIT_DELAYED_WORK(&pipe->queue_timeout,
			    rpc_timeout_upcall_queue);
	pipe->ops = NULL;
	spin_lock_init(&pipe->lock);
563 564
	pipe->dentry = NULL;
}
565

566 567 568
void rpc_destroy_pipe_data(struct rpc_pipe *pipe)
{
	kfree(pipe);
569
}
570
EXPORT_SYMBOL_GPL(rpc_destroy_pipe_data);
571

572
struct rpc_pipe *rpc_mkpipe_data(const struct rpc_pipe_ops *ops, int flags)
573
{
574
	struct rpc_pipe *pipe;
575

576 577
	pipe = kzalloc(sizeof(struct rpc_pipe), GFP_KERNEL);
	if (!pipe)
578
		return ERR_PTR(-ENOMEM);
579
	init_pipe(pipe);
580 581 582 583 584 585 586 587 588 589 590 591 592 593 594
	pipe->ops = ops;
	pipe->flags = flags;
	return pipe;
}
EXPORT_SYMBOL_GPL(rpc_mkpipe_data);

static int __rpc_mkpipe_dentry(struct inode *dir, struct dentry *dentry,
			       umode_t mode,
			       const struct file_operations *i_fop,
			       void *private,
			       struct rpc_pipe *pipe)
{
	struct rpc_inode *rpci;
	int err;

595
	err = __rpc_create_common(dir, dentry, S_IFIFO | mode, i_fop, private);
596
	if (err)
597 598 599
		return err;
	rpci = RPC_I(dentry->d_inode);
	rpci->private = private;
600
	rpci->pipe = pipe;
601 602 603 604
	fsnotify_create(dir, dentry);
	return 0;
}

605 606 607 608 609 610 611 612 613 614 615
static int __rpc_rmdir(struct inode *dir, struct dentry *dentry)
{
	int ret;

	dget(dentry);
	ret = simple_rmdir(dir, dentry);
	d_delete(dentry);
	dput(dentry);
	return ret;
}

616 617 618 619 620 621 622 623 624 625 626 627 628 629 630 631
int rpc_rmdir(struct dentry *dentry)
{
	struct dentry *parent;
	struct inode *dir;
	int error;

	parent = dget_parent(dentry);
	dir = parent->d_inode;
	mutex_lock_nested(&dir->i_mutex, I_MUTEX_PARENT);
	error = __rpc_rmdir(dir, dentry);
	mutex_unlock(&dir->i_mutex);
	dput(parent);
	return error;
}
EXPORT_SYMBOL_GPL(rpc_rmdir);

T
Trond Myklebust 已提交
632 633 634 635 636 637 638 639 640 641 642 643 644 645 646 647 648 649 650
static int __rpc_unlink(struct inode *dir, struct dentry *dentry)
{
	int ret;

	dget(dentry);
	ret = simple_unlink(dir, dentry);
	d_delete(dentry);
	dput(dentry);
	return ret;
}

static int __rpc_rmpipe(struct inode *dir, struct dentry *dentry)
{
	struct inode *inode = dentry->d_inode;

	rpc_close_pipes(inode);
	return __rpc_unlink(dir, dentry);
}

651
static struct dentry *__rpc_lookup_create_exclusive(struct dentry *parent,
652 653 654 655 656 657 658
					  struct qstr *name)
{
	struct dentry *dentry;

	dentry = d_lookup(parent, name);
	if (!dentry) {
		dentry = d_alloc(parent, name);
659 660
		if (!dentry)
			return ERR_PTR(-ENOMEM);
661
	}
662
	if (dentry->d_inode == NULL) {
663
		d_set_d_op(dentry, &rpc_dentry_operations);
664
		return dentry;
665
	}
666 667 668 669
	dput(dentry);
	return ERR_PTR(-EEXIST);
}

L
Linus Torvalds 已提交
670 671 672
/*
 * FIXME: This probably has races.
 */
673 674 675
static void __rpc_depopulate(struct dentry *parent,
			     const struct rpc_filelist *files,
			     int start, int eof)
L
Linus Torvalds 已提交
676 677
{
	struct inode *dir = parent->d_inode;
678 679 680
	struct dentry *dentry;
	struct qstr name;
	int i;
L
Linus Torvalds 已提交
681

682 683 684 685 686 687 688
	for (i = start; i < eof; i++) {
		name.name = files[i].name;
		name.len = strlen(files[i].name);
		name.hash = full_name_hash(name.name, name.len);
		dentry = d_lookup(parent, &name);

		if (dentry == NULL)
T
Trond Myklebust 已提交
689
			continue;
690 691 692 693 694 695 696
		if (dentry->d_inode == NULL)
			goto next;
		switch (dentry->d_inode->i_mode & S_IFMT) {
			default:
				BUG();
			case S_IFREG:
				__rpc_unlink(dir, dentry);
L
Linus Torvalds 已提交
697
				break;
698 699 700 701 702
			case S_IFDIR:
				__rpc_rmdir(dir, dentry);
		}
next:
		dput(dentry);
L
Linus Torvalds 已提交
703
	}
704 705 706 707 708 709 710 711 712 713
}

static void rpc_depopulate(struct dentry *parent,
			   const struct rpc_filelist *files,
			   int start, int eof)
{
	struct inode *dir = parent->d_inode;

	mutex_lock_nested(&dir->i_mutex, I_MUTEX_CHILD);
	__rpc_depopulate(parent, files, start, eof);
714
	mutex_unlock(&dir->i_mutex);
L
Linus Torvalds 已提交
715 716
}

717 718 719 720
static int rpc_populate(struct dentry *parent,
			const struct rpc_filelist *files,
			int start, int eof,
			void *private)
L
Linus Torvalds 已提交
721
{
722
	struct inode *dir = parent->d_inode;
L
Linus Torvalds 已提交
723
	struct dentry *dentry;
724
	int i, err;
L
Linus Torvalds 已提交
725

726
	mutex_lock(&dir->i_mutex);
L
Linus Torvalds 已提交
727
	for (i = start; i < eof; i++) {
728 729 730 731 732 733 734 735
		struct qstr q;

		q.name = files[i].name;
		q.len = strlen(files[i].name);
		q.hash = full_name_hash(q.name, q.len);
		dentry = __rpc_lookup_create_exclusive(parent, &q);
		err = PTR_ERR(dentry);
		if (IS_ERR(dentry))
L
Linus Torvalds 已提交
736
			goto out_bad;
737 738 739 740 741 742 743 744 745 746 747 748 749 750
		switch (files[i].mode & S_IFMT) {
			default:
				BUG();
			case S_IFREG:
				err = __rpc_create(dir, dentry,
						files[i].mode,
						files[i].i_fop,
						private);
				break;
			case S_IFDIR:
				err = __rpc_mkdir(dir, dentry,
						files[i].mode,
						NULL,
						private);
L
Linus Torvalds 已提交
751
		}
752 753
		if (err != 0)
			goto out_bad;
L
Linus Torvalds 已提交
754
	}
755
	mutex_unlock(&dir->i_mutex);
L
Linus Torvalds 已提交
756 757
	return 0;
out_bad:
758
	__rpc_depopulate(parent, files, start, eof);
759
	mutex_unlock(&dir->i_mutex);
L
Linus Torvalds 已提交
760
	printk(KERN_WARNING "%s: %s failed to populate directory %s\n",
761
			__FILE__, __func__, parent->d_name.name);
762
	return err;
763
}
L
Linus Torvalds 已提交
764

765 766 767
static struct dentry *rpc_mkdir_populate(struct dentry *parent,
		struct qstr *name, umode_t mode, void *private,
		int (*populate)(struct dentry *, void *), void *args_populate)
768 769
{
	struct dentry *dentry;
770
	struct inode *dir = parent->d_inode;
771 772
	int error;

773 774
	mutex_lock_nested(&dir->i_mutex, I_MUTEX_PARENT);
	dentry = __rpc_lookup_create_exclusive(parent, name);
775
	if (IS_ERR(dentry))
776 777
		goto out;
	error = __rpc_mkdir(dir, dentry, mode, NULL, private);
778 779
	if (error != 0)
		goto out_err;
780 781 782 783 784
	if (populate != NULL) {
		error = populate(dentry, args_populate);
		if (error)
			goto err_rmdir;
	}
785
out:
786
	mutex_unlock(&dir->i_mutex);
787
	return dentry;
788
err_rmdir:
789
	__rpc_rmdir(dir, dentry);
790
out_err:
791 792
	dentry = ERR_PTR(error);
	goto out;
L
Linus Torvalds 已提交
793 794
}

795 796
static int rpc_rmdir_depopulate(struct dentry *dentry,
		void (*depopulate)(struct dentry *))
L
Linus Torvalds 已提交
797
{
T
Trond Myklebust 已提交
798
	struct dentry *parent;
799 800
	struct inode *dir;
	int error;
801

T
Trond Myklebust 已提交
802 803
	parent = dget_parent(dentry);
	dir = parent->d_inode;
804
	mutex_lock_nested(&dir->i_mutex, I_MUTEX_PARENT);
805 806
	if (depopulate != NULL)
		depopulate(dentry);
807
	error = __rpc_rmdir(dir, dentry);
808
	mutex_unlock(&dir->i_mutex);
T
Trond Myklebust 已提交
809
	dput(parent);
810
	return error;
L
Linus Torvalds 已提交
811 812
}

813 814 815 816 817 818
/**
 * rpc_mkpipe - make an rpc_pipefs file for kernel<->userspace communication
 * @parent: dentry of directory to create new "pipe" in
 * @name: name of pipe
 * @private: private data to associate with the pipe, for the caller's use
 * @ops: operations defining the behavior of the pipe: upcall, downcall,
819
 *	release_pipe, open_pipe, and destroy_msg.
820
 * @flags: rpc_pipe flags
821 822 823 824 825 826 827 828 829 830 831 832
 *
 * Data is made available for userspace to read by calls to
 * rpc_queue_upcall().  The actual reads will result in calls to
 * @ops->upcall, which will be called with the file pointer,
 * message, and userspace buffer to copy to.
 *
 * Writes can come at any time, and do not necessarily have to be
 * responses to upcalls.  They will result in calls to @msg->downcall.
 *
 * The @private argument passed here will be available to all these methods
 * from the file pointer, via RPC_I(file->f_dentry->d_inode)->private.
 */
833 834
struct dentry *rpc_mkpipe_dentry(struct dentry *parent, const char *name,
				 void *private, struct rpc_pipe *pipe)
L
Linus Torvalds 已提交
835 836
{
	struct dentry *dentry;
837
	struct inode *dir = parent->d_inode;
838
	umode_t umode = S_IFIFO | S_IRUSR | S_IWUSR;
839
	struct qstr q;
840
	int err;
841

842
	if (pipe->ops->upcall == NULL)
843
		umode &= ~S_IRUGO;
844
	if (pipe->ops->downcall == NULL)
845
		umode &= ~S_IWUGO;
L
Linus Torvalds 已提交
846

847 848 849 850 851
	q.name = name;
	q.len = strlen(name);
	q.hash = full_name_hash(q.name, q.len),

	mutex_lock_nested(&dir->i_mutex, I_MUTEX_PARENT);
852
	dentry = __rpc_lookup_create_exclusive(parent, &q);
L
Linus Torvalds 已提交
853
	if (IS_ERR(dentry))
854
		goto out;
855 856
	err = __rpc_mkpipe_dentry(dir, dentry, umode, &rpc_pipe_fops,
				  private, pipe);
857 858
	if (err)
		goto out_err;
859
out:
860
	mutex_unlock(&dir->i_mutex);
861
	return dentry;
862 863
out_err:
	dentry = ERR_PTR(err);
864
	printk(KERN_WARNING "%s: %s() failed to create pipe %s/%s (errno = %d)\n",
865
			__FILE__, __func__, parent->d_name.name, name,
866
			err);
867
	goto out;
L
Linus Torvalds 已提交
868
}
869
EXPORT_SYMBOL_GPL(rpc_mkpipe_dentry);
L
Linus Torvalds 已提交
870

871 872 873 874 875 876 877 878
/**
 * rpc_unlink - remove a pipe
 * @dentry: dentry for the pipe, as returned from rpc_mkpipe
 *
 * After this call, lookups will no longer find the pipe, and any
 * attempts to read or write using preexisting opens of the pipe will
 * return -EPIPE.
 */
879
int
880
rpc_unlink(struct dentry *dentry)
L
Linus Torvalds 已提交
881
{
882
	struct dentry *parent;
883
	struct inode *dir;
884
	int error = 0;
L
Linus Torvalds 已提交
885

886 887
	parent = dget_parent(dentry);
	dir = parent->d_inode;
888
	mutex_lock_nested(&dir->i_mutex, I_MUTEX_PARENT);
T
Trond Myklebust 已提交
889
	error = __rpc_rmpipe(dir, dentry);
890
	mutex_unlock(&dir->i_mutex);
891
	dput(parent);
892
	return error;
L
Linus Torvalds 已提交
893
}
894
EXPORT_SYMBOL_GPL(rpc_unlink);
L
Linus Torvalds 已提交
895

896 897 898 899 900 901 902 903 904 905 906 907 908 909 910 911 912 913 914 915 916 917 918 919 920
enum {
	RPCAUTH_info,
	RPCAUTH_EOF
};

static const struct rpc_filelist authfiles[] = {
	[RPCAUTH_info] = {
		.name = "info",
		.i_fop = &rpc_info_operations,
		.mode = S_IFREG | S_IRUSR,
	},
};

static int rpc_clntdir_populate(struct dentry *dentry, void *private)
{
	return rpc_populate(dentry,
			    authfiles, RPCAUTH_info, RPCAUTH_EOF,
			    private);
}

static void rpc_clntdir_depopulate(struct dentry *dentry)
{
	rpc_depopulate(dentry, authfiles, RPCAUTH_info, RPCAUTH_EOF);
}

921 922
/**
 * rpc_create_client_dir - Create a new rpc_client directory in rpc_pipefs
923 924
 * @dentry: dentry from the rpc_pipefs root to the new directory
 * @name: &struct qstr for the name
925 926 927 928 929 930 931
 * @rpc_client: rpc client to associate with this directory
 *
 * This creates a directory at the given @path associated with
 * @rpc_clnt, which will contain a file named "info" with some basic
 * information about the client, together with any "pipes" that may
 * later be created using rpc_mkpipe().
 */
932
struct dentry *rpc_create_client_dir(struct dentry *dentry,
933 934 935 936 937 938 939 940 941
				   struct qstr *name,
				   struct rpc_clnt *rpc_client)
{
	return rpc_mkdir_populate(dentry, name, S_IRUGO | S_IXUGO, NULL,
			rpc_clntdir_populate, rpc_client);
}

/**
 * rpc_remove_client_dir - Remove a directory created with rpc_create_client_dir()
942
 * @clnt: rpc client
943 944
 */
int rpc_remove_client_dir(struct dentry *dentry)
945
{
946
	return rpc_rmdir_depopulate(dentry, rpc_clntdir_depopulate);
947 948
}

949 950 951 952
static const struct rpc_filelist cache_pipefs_files[3] = {
	[0] = {
		.name = "channel",
		.i_fop = &cache_file_operations_pipefs,
953
		.mode = S_IFREG|S_IRUSR|S_IWUSR,
954 955 956 957 958 959 960 961 962 963 964 965 966 967 968 969 970 971 972 973 974 975 976 977 978 979
	},
	[1] = {
		.name = "content",
		.i_fop = &content_file_operations_pipefs,
		.mode = S_IFREG|S_IRUSR,
	},
	[2] = {
		.name = "flush",
		.i_fop = &cache_flush_operations_pipefs,
		.mode = S_IFREG|S_IRUSR|S_IWUSR,
	},
};

static int rpc_cachedir_populate(struct dentry *dentry, void *private)
{
	return rpc_populate(dentry,
			    cache_pipefs_files, 0, 3,
			    private);
}

static void rpc_cachedir_depopulate(struct dentry *dentry)
{
	rpc_depopulate(dentry, cache_pipefs_files, 0, 3);
}

struct dentry *rpc_create_cache_dir(struct dentry *parent, struct qstr *name,
A
Al Viro 已提交
980
				    umode_t umode, struct cache_detail *cd)
981 982 983 984 985 986 987 988 989 990
{
	return rpc_mkdir_populate(parent, name, umode, NULL,
			rpc_cachedir_populate, cd);
}

void rpc_remove_cache_dir(struct dentry *dentry)
{
	rpc_rmdir_depopulate(dentry, rpc_cachedir_depopulate);
}

L
Linus Torvalds 已提交
991 992 993
/*
 * populate the filesystem
 */
994
static const struct super_operations s_ops = {
L
Linus Torvalds 已提交
995 996 997 998 999 1000 1001
	.alloc_inode	= rpc_alloc_inode,
	.destroy_inode	= rpc_destroy_inode,
	.statfs		= simple_statfs,
};

#define RPCAUTH_GSSMAGIC 0x67596969

T
Trond Myklebust 已提交
1002 1003 1004 1005 1006 1007 1008 1009 1010 1011
/*
 * We have a single directory with 1 node in it.
 */
enum {
	RPCAUTH_lockd,
	RPCAUTH_mount,
	RPCAUTH_nfs,
	RPCAUTH_portmap,
	RPCAUTH_statd,
	RPCAUTH_nfsd4_cb,
1012
	RPCAUTH_cache,
T
Trond Myklebust 已提交
1013 1014 1015 1016 1017 1018 1019 1020 1021 1022 1023 1024 1025 1026 1027 1028 1029 1030 1031 1032 1033 1034 1035 1036 1037 1038 1039 1040
	RPCAUTH_RootEOF
};

static const struct rpc_filelist files[] = {
	[RPCAUTH_lockd] = {
		.name = "lockd",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
	[RPCAUTH_mount] = {
		.name = "mount",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
	[RPCAUTH_nfs] = {
		.name = "nfs",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
	[RPCAUTH_portmap] = {
		.name = "portmap",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
	[RPCAUTH_statd] = {
		.name = "statd",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
	[RPCAUTH_nfsd4_cb] = {
		.name = "nfsd4_cb",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
1041 1042 1043 1044
	[RPCAUTH_cache] = {
		.name = "cache",
		.mode = S_IFDIR | S_IRUGO | S_IXUGO,
	},
T
Trond Myklebust 已提交
1045 1046
};

1047 1048 1049 1050 1051 1052 1053 1054 1055 1056 1057 1058 1059 1060 1061 1062
/*
 * This call can be used only in RPC pipefs mount notification hooks.
 */
struct dentry *rpc_d_lookup_sb(const struct super_block *sb,
			       const unsigned char *dir_name)
{
	struct qstr dir = {
		.name = dir_name,
		.len = strlen(dir_name),
		.hash = full_name_hash(dir_name, strlen(dir_name)),
	};

	return d_lookup(sb->s_root, &dir);
}
EXPORT_SYMBOL_GPL(rpc_d_lookup_sb);

1063 1064 1065 1066 1067 1068 1069 1070 1071 1072 1073 1074 1075 1076 1077 1078 1079 1080 1081 1082 1083 1084 1085 1086 1087 1088 1089 1090 1091 1092 1093 1094 1095 1096
void rpc_pipefs_init_net(struct net *net)
{
	struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);

	mutex_init(&sn->pipefs_sb_lock);
}

/*
 * This call will be used for per network namespace operations calls.
 * Note: Function will be returned with pipefs_sb_lock taken if superblock was
 * found. This lock have to be released by rpc_put_sb_net() when all operations
 * will be completed.
 */
struct super_block *rpc_get_sb_net(const struct net *net)
{
	struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);

	mutex_lock(&sn->pipefs_sb_lock);
	if (sn->pipefs_sb)
		return sn->pipefs_sb;
	mutex_unlock(&sn->pipefs_sb_lock);
	return NULL;
}
EXPORT_SYMBOL_GPL(rpc_get_sb_net);

void rpc_put_sb_net(const struct net *net)
{
	struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);

	BUG_ON(sn->pipefs_sb == NULL);
	mutex_unlock(&sn->pipefs_sb_lock);
}
EXPORT_SYMBOL_GPL(rpc_put_sb_net);

L
Linus Torvalds 已提交
1097 1098 1099 1100 1101
static int
rpc_fill_super(struct super_block *sb, void *data, int silent)
{
	struct inode *inode;
	struct dentry *root;
1102
	struct net *net = data;
1103
	struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
1104
	int err;
L
Linus Torvalds 已提交
1105 1106 1107 1108 1109 1110 1111 1112 1113 1114

	sb->s_blocksize = PAGE_CACHE_SIZE;
	sb->s_blocksize_bits = PAGE_CACHE_SHIFT;
	sb->s_magic = RPCAUTH_GSSMAGIC;
	sb->s_op = &s_ops;
	sb->s_time_gran = 1;

	inode = rpc_get_inode(sb, S_IFDIR | 0755);
	if (!inode)
		return -ENOMEM;
1115
	sb->s_root = root = d_alloc_root(inode);
L
Linus Torvalds 已提交
1116 1117 1118 1119
	if (!root) {
		iput(inode);
		return -ENOMEM;
	}
1120
	if (rpc_populate(root, files, RPCAUTH_lockd, RPCAUTH_RootEOF, NULL))
1121
		return -ENOMEM;
1122 1123
	dprintk("RPC:	sending pipefs MOUNT notification for net %p%s\n", net,
								NET_NAME(net));
1124 1125 1126 1127 1128
	err = blocking_notifier_call_chain(&rpc_pipefs_notifier_list,
					   RPC_PIPEFS_MOUNT,
					   sb);
	if (err)
		goto err_depopulate;
1129
	sb->s_fs_info = get_net(net);
1130
	sn->pipefs_sb = sb;
L
Linus Torvalds 已提交
1131
	return 0;
1132 1133 1134 1135 1136 1137 1138

err_depopulate:
	blocking_notifier_call_chain(&rpc_pipefs_notifier_list,
					   RPC_PIPEFS_UMOUNT,
					   sb);
	__rpc_depopulate(root, files, RPCAUTH_lockd, RPCAUTH_RootEOF);
	return err;
L
Linus Torvalds 已提交
1139 1140
}

A
Al Viro 已提交
1141 1142 1143
static struct dentry *
rpc_mount(struct file_system_type *fs_type,
		int flags, const char *dev_name, void *data)
L
Linus Torvalds 已提交
1144
{
1145
	return mount_ns(fs_type, flags, current->nsproxy->net_ns, rpc_fill_super);
L
Linus Torvalds 已提交
1146 1147
}

1148 1149 1150
void rpc_kill_sb(struct super_block *sb)
{
	struct net *net = sb->s_fs_info;
1151
	struct sunrpc_net *sn = net_generic(net, sunrpc_net_id);
1152

1153
	mutex_lock(&sn->pipefs_sb_lock);
1154
	sn->pipefs_sb = NULL;
1155
	mutex_unlock(&sn->pipefs_sb_lock);
1156
	put_net(net);
1157 1158
	dprintk("RPC:	sending pipefs UMOUNT notification for net %p%s\n", net,
								NET_NAME(net));
1159 1160 1161
	blocking_notifier_call_chain(&rpc_pipefs_notifier_list,
					   RPC_PIPEFS_UMOUNT,
					   sb);
1162 1163 1164
	kill_litter_super(sb);
}

L
Linus Torvalds 已提交
1165 1166 1167
static struct file_system_type rpc_pipe_fs_type = {
	.owner		= THIS_MODULE,
	.name		= "rpc_pipefs",
A
Al Viro 已提交
1168
	.mount		= rpc_mount,
1169
	.kill_sb	= rpc_kill_sb,
L
Linus Torvalds 已提交
1170 1171 1172
};

static void
1173
init_once(void *foo)
L
Linus Torvalds 已提交
1174 1175 1176
{
	struct rpc_inode *rpci = (struct rpc_inode *) foo;

C
Christoph Lameter 已提交
1177 1178
	inode_init_once(&rpci->vfs_inode);
	rpci->private = NULL;
1179
	rpci->pipe = NULL;
1180
	init_waitqueue_head(&rpci->waitq);
L
Linus Torvalds 已提交
1181 1182 1183 1184
}

int register_rpc_pipefs(void)
{
1185 1186
	int err;

L
Linus Torvalds 已提交
1187
	rpc_inode_cachep = kmem_cache_create("rpc_inode_cache",
1188 1189 1190
				sizeof(struct rpc_inode),
				0, (SLAB_HWCACHE_ALIGN|SLAB_RECLAIM_ACCOUNT|
						SLAB_MEM_SPREAD),
1191
				init_once);
L
Linus Torvalds 已提交
1192 1193
	if (!rpc_inode_cachep)
		return -ENOMEM;
1194 1195 1196
	err = rpc_clients_notifier_register();
	if (err)
		goto err_notifier;
1197
	err = register_filesystem(&rpc_pipe_fs_type);
1198 1199
	if (err)
		goto err_register;
L
Linus Torvalds 已提交
1200
	return 0;
1201 1202 1203 1204 1205 1206

err_register:
	rpc_clients_notifier_unregister();
err_notifier:
	kmem_cache_destroy(rpc_inode_cachep);
	return err;
L
Linus Torvalds 已提交
1207 1208 1209 1210
}

void unregister_rpc_pipefs(void)
{
1211
	rpc_clients_notifier_unregister();
1212
	kmem_cache_destroy(rpc_inode_cachep);
L
Linus Torvalds 已提交
1213 1214
	unregister_filesystem(&rpc_pipe_fs_type);
}
1215 1216 1217

/* Make 'mount -t rpc_pipefs ...' autoload this module. */
MODULE_ALIAS("rpc_pipefs");