[people/ms/linux.git] / drivers / staging / lustre / include / linux / libcfs / libcfs_ioctl.h

/*
 * GPL HEADER START
 *
 * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
 *
 * This program is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License version 2 only,
 * as published by the Free Software Foundation.
 *
 * This program is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
 * General Public License version 2 for more details (a copy is included
 * in the LICENSE file that accompanied this code).
 *
 * You should have received a copy of the GNU General Public License
 * version 2 along with this program; If not, see
 * http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
 *
 * Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
 * CA 95054 USA or visit www.sun.com if you need additional information or
 * have any questions.
 *
 * GPL HEADER END
 */
/*
 * Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
 * Use is subject to license terms.
 */
/*
 * This file is part of Lustre, http://www.lustre.org/
 * Lustre is a trademark of Sun Microsystems, Inc.
 *
 * libcfs/include/libcfs/libcfs_ioctl.h
 *
 * Low-level ioctl data structures. Kernel ioctl functions declared here,
 * and user space functions are in libcfsutil_ioctl.h.
 *
 */

#ifndef __LIBCFS_IOCTL_H__
#define __LIBCFS_IOCTL_H__

#define LIBCFS_IOCTL_VERSION 0x0001000a

struct libcfs_ioctl_data {
	__u32 ioc_len;
	__u32 ioc_version;

	__u64 ioc_nid;
	__u64 ioc_u64[1];

	__u32 ioc_flags;
	__u32 ioc_count;
	__u32 ioc_net;
	__u32 ioc_u32[7];

	__u32 ioc_inllen1;
	char *ioc_inlbuf1;
	__u32 ioc_inllen2;
	char *ioc_inlbuf2;

	__u32 ioc_plen1; /* buffers in userspace */
	char *ioc_pbuf1;
	__u32 ioc_plen2; /* buffers in userspace */
	char *ioc_pbuf2;

	char ioc_bulk[0];
};

#define ioc_priority ioc_u32[0]

struct libcfs_ioctl_hdr {
	__u32 ioc_len;
	__u32 ioc_version;
};

struct libcfs_debug_ioctl_data {
	struct libcfs_ioctl_hdr hdr;
	unsigned int subs;
	unsigned int debug;
};

#define LIBCFS_IOC_INIT(data)			   \
do {						    \
	memset(&data, 0, sizeof(data));		 \
	data.ioc_version = LIBCFS_IOCTL_VERSION;	\
	data.ioc_len = sizeof(data);		    \
} while (0)

struct libcfs_ioctl_handler {
	struct list_head item;
	int (*handle_ioctl)(unsigned int cmd, struct libcfs_ioctl_data *data);
};

#define DECLARE_IOCTL_HANDLER(ident, func)		      \
	struct libcfs_ioctl_handler ident = {		   \
		/* .item = */ LIST_HEAD_INIT(ident.item),   \
		/* .handle_ioctl = */ func		      \
	}

/* FIXME check conflict with lustre_lib.h */
#define LIBCFS_IOC_DEBUG_MASK	     _IOWR('f', 250, long)

/* ioctls for manipulating snapshots 30- */
#define IOC_LIBCFS_TYPE		   'e'
#define IOC_LIBCFS_MIN_NR		 30
/* libcfs ioctls */
#define IOC_LIBCFS_PANIC		   _IOWR('e', 30, long)
#define IOC_LIBCFS_CLEAR_DEBUG	     _IOWR('e', 31, long)
#define IOC_LIBCFS_MARK_DEBUG	      _IOWR('e', 32, long)
#define IOC_LIBCFS_MEMHOG		  _IOWR('e', 36, long)
/* lnet ioctls */
#define IOC_LIBCFS_GET_NI		  _IOWR('e', 50, long)
#define IOC_LIBCFS_FAIL_NID		_IOWR('e', 51, long)
#define IOC_LIBCFS_ADD_ROUTE	       _IOWR('e', 52, long)
#define IOC_LIBCFS_DEL_ROUTE	       _IOWR('e', 53, long)
#define IOC_LIBCFS_GET_ROUTE	       _IOWR('e', 54, long)
#define IOC_LIBCFS_NOTIFY_ROUTER	   _IOWR('e', 55, long)
#define IOC_LIBCFS_UNCONFIGURE	     _IOWR('e', 56, long)
#define IOC_LIBCFS_PORTALS_COMPATIBILITY   _IOWR('e', 57, long)
#define IOC_LIBCFS_LNET_DIST	       _IOWR('e', 58, long)
#define IOC_LIBCFS_CONFIGURE	       _IOWR('e', 59, long)
#define IOC_LIBCFS_TESTPROTOCOMPAT	 _IOWR('e', 60, long)
#define IOC_LIBCFS_PING		    _IOWR('e', 61, long)
#define IOC_LIBCFS_DEBUG_PEER	      _IOWR('e', 62, long)
#define IOC_LIBCFS_LNETST		  _IOWR('e', 63, long)
/* lnd ioctls */
#define IOC_LIBCFS_REGISTER_MYNID	  _IOWR('e', 70, long)
#define IOC_LIBCFS_CLOSE_CONNECTION	_IOWR('e', 71, long)
#define IOC_LIBCFS_PUSH_CONNECTION	 _IOWR('e', 72, long)
#define IOC_LIBCFS_GET_CONN		_IOWR('e', 73, long)
#define IOC_LIBCFS_DEL_PEER		_IOWR('e', 74, long)
#define IOC_LIBCFS_ADD_PEER		_IOWR('e', 75, long)
#define IOC_LIBCFS_GET_PEER		_IOWR('e', 76, long)
/* ioctl 77 is free for use */
#define IOC_LIBCFS_ADD_INTERFACE	   _IOWR('e', 78, long)
#define IOC_LIBCFS_DEL_INTERFACE	   _IOWR('e', 79, long)
#define IOC_LIBCFS_GET_INTERFACE	   _IOWR('e', 80, long)

#define IOC_LIBCFS_MAX_NR			     80

static inline int libcfs_ioctl_packlen(struct libcfs_ioctl_data *data)
{
	int len = sizeof(*data);

	len += cfs_size_round(data->ioc_inllen1);
	len += cfs_size_round(data->ioc_inllen2);
	return len;
}

static inline int libcfs_ioctl_is_invalid(struct libcfs_ioctl_data *data)
{
	if (data->ioc_len > (1<<30)) {
		CERROR("LIBCFS ioctl: ioc_len larger than 1<<30\n");
		return 1;
	}
	if (data->ioc_inllen1 > (1<<30)) {
		CERROR("LIBCFS ioctl: ioc_inllen1 larger than 1<<30\n");
		return 1;
	}
	if (data->ioc_inllen2 > (1<<30)) {
		CERROR("LIBCFS ioctl: ioc_inllen2 larger than 1<<30\n");
		return 1;
	}
	if (data->ioc_inlbuf1 && !data->ioc_inllen1) {
		CERROR("LIBCFS ioctl: inlbuf1 pointer but 0 length\n");
		return 1;
	}
	if (data->ioc_inlbuf2 && !data->ioc_inllen2) {
		CERROR("LIBCFS ioctl: inlbuf2 pointer but 0 length\n");
		return 1;
	}
	if (data->ioc_pbuf1 && !data->ioc_plen1) {
		CERROR("LIBCFS ioctl: pbuf1 pointer but 0 length\n");
		return 1;
	}
	if (data->ioc_pbuf2 && !data->ioc_plen2) {
		CERROR("LIBCFS ioctl: pbuf2 pointer but 0 length\n");
		return 1;
	}
	if (data->ioc_plen1 && !data->ioc_pbuf1) {
		CERROR("LIBCFS ioctl: plen1 nonzero but no pbuf1 pointer\n");
		return 1;
	}
	if (data->ioc_plen2 && !data->ioc_pbuf2) {
		CERROR("LIBCFS ioctl: plen2 nonzero but no pbuf2 pointer\n");
		return 1;
	}
	if ((__u32)libcfs_ioctl_packlen(data) != data->ioc_len) {
		CERROR("LIBCFS ioctl: packlen != ioc_len\n");
		return 1;
	}
	if (data->ioc_inllen1 &&
	    data->ioc_bulk[data->ioc_inllen1 - 1] != '\0') {
		CERROR("LIBCFS ioctl: inlbuf1 not 0 terminated\n");
		return 1;
	}
	if (data->ioc_inllen2 &&
	    data->ioc_bulk[cfs_size_round(data->ioc_inllen1) +
			   data->ioc_inllen2 - 1] != '\0') {
		CERROR("LIBCFS ioctl: inlbuf2 not 0 terminated\n");
		return 1;
	}
	return 0;
}

int libcfs_register_ioctl(struct libcfs_ioctl_handler *hand);
int libcfs_deregister_ioctl(struct libcfs_ioctl_handler *hand);
int libcfs_ioctl_getdata(char *buf, char *end, void *arg);
int libcfs_ioctl_popdata(void *arg, void *buf, int size);

#endif /* __LIBCFS_IOCTL_H__ */
Commit	Line	Data
d7e09d03 PT	1	/*
	2	* GPL HEADER START
	3	*
	4	* DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER.
	5	*
	6	* This program is free software; you can redistribute it and/or modify
	7	* it under the terms of the GNU General Public License version 2 only,
	8	* as published by the Free Software Foundation.
	9	*
	10	* This program is distributed in the hope that it will be useful, but
	11	* WITHOUT ANY WARRANTY; without even the implied warranty of
	12	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
	13	* General Public License version 2 for more details (a copy is included
	14	* in the LICENSE file that accompanied this code).
	15	*
	16	* You should have received a copy of the GNU General Public License
	17	* version 2 along with this program; If not, see
	18	* http://www.sun.com/software/products/lustre/docs/GPLv2.pdf
	19	*
	20	* Please contact Sun Microsystems, Inc., 4150 Network Circle, Santa Clara,
	21	* CA 95054 USA or visit www.sun.com if you need additional information or
	22	* have any questions.
	23	*
	24	* GPL HEADER END
	25	*/
	26	/*
	27	* Copyright (c) 2008, 2010, Oracle and/or its affiliates. All rights reserved.
	28	* Use is subject to license terms.
	29	*/
	30	/*
	31	* This file is part of Lustre, http://www.lustre.org/
	32	* Lustre is a trademark of Sun Microsystems, Inc.
	33	*
	34	* libcfs/include/libcfs/libcfs_ioctl.h
	35	*
	36	* Low-level ioctl data structures. Kernel ioctl functions declared here,
	37	* and user space functions are in libcfsutil_ioctl.h.
	38	*
	39	*/
	40
	41	#ifndef __LIBCFS_IOCTL_H__
	42	#define __LIBCFS_IOCTL_H__
	43
d7e09d03 PT	44	#define LIBCFS_IOCTL_VERSION 0x0001000a
	45
	46	struct libcfs_ioctl_data {
	47	__u32 ioc_len;
	48	__u32 ioc_version;
	49
	50	__u64 ioc_nid;
	51	__u64 ioc_u64[1];
	52
	53	__u32 ioc_flags;
	54	__u32 ioc_count;
	55	__u32 ioc_net;
	56	__u32 ioc_u32[7];
	57
	58	__u32 ioc_inllen1;
	59	char *ioc_inlbuf1;
	60	__u32 ioc_inllen2;
	61	char *ioc_inlbuf2;
	62
	63	__u32 ioc_plen1; /* buffers in userspace */
	64	char *ioc_pbuf1;
	65	__u32 ioc_plen2; /* buffers in userspace */
	66	char *ioc_pbuf2;
	67
	68	char ioc_bulk[0];
	69	};
	70
e75fb87f	71	#define ioc_priority ioc_u32[0]
d7e09d03 PT	72
	73	struct libcfs_ioctl_hdr {
	74	__u32 ioc_len;
	75	__u32 ioc_version;
	76	};
	77
6606a77f	78	struct libcfs_debug_ioctl_data {
d7e09d03 PT	79	struct libcfs_ioctl_hdr hdr;
	80	unsigned int subs;
	81	unsigned int debug;
	82	};
	83
	84	#define LIBCFS_IOC_INIT(data) \
	85	do { \
	86	memset(&data, 0, sizeof(data)); \
	87	data.ioc_version = LIBCFS_IOCTL_VERSION; \
	88	data.ioc_len = sizeof(data); \
	89	} while (0)
	90
d7e09d03 PT	91	struct libcfs_ioctl_handler {
	92	struct list_head item;
	93	int (handle_ioctl)(unsigned int cmd, struct libcfs_ioctl_data data);
	94	};
	95
	96	#define DECLARE_IOCTL_HANDLER(ident, func) \
	97	struct libcfs_ioctl_handler ident = { \
	98	/* .item = */ LIST_HEAD_INIT(ident.item), \
	99	/* .handle_ioctl = */ func \
	100	}
	101
d7e09d03 PT	102	/* FIXME check conflict with lustre_lib.h */
	103	#define LIBCFS_IOC_DEBUG_MASK _IOWR('f', 250, long)
	104
d7e09d03 PT	105	/* ioctls for manipulating snapshots 30- */
	106	#define IOC_LIBCFS_TYPE 'e'
	107	#define IOC_LIBCFS_MIN_NR 30
	108	/* libcfs ioctls */
6be96847 PT	109	#define IOC_LIBCFS_PANIC _IOWR('e', 30, long)
	110	#define IOC_LIBCFS_CLEAR_DEBUG _IOWR('e', 31, long)
	111	#define IOC_LIBCFS_MARK_DEBUG _IOWR('e', 32, long)
6be96847	112	#define IOC_LIBCFS_MEMHOG _IOWR('e', 36, long)
d7e09d03	113	/* lnet ioctls */
6be96847 PT	114	#define IOC_LIBCFS_GET_NI _IOWR('e', 50, long)
	115	#define IOC_LIBCFS_FAIL_NID _IOWR('e', 51, long)
	116	#define IOC_LIBCFS_ADD_ROUTE _IOWR('e', 52, long)
	117	#define IOC_LIBCFS_DEL_ROUTE _IOWR('e', 53, long)
	118	#define IOC_LIBCFS_GET_ROUTE _IOWR('e', 54, long)
	119	#define IOC_LIBCFS_NOTIFY_ROUTER _IOWR('e', 55, long)
	120	#define IOC_LIBCFS_UNCONFIGURE _IOWR('e', 56, long)
	121	#define IOC_LIBCFS_PORTALS_COMPATIBILITY _IOWR('e', 57, long)
	122	#define IOC_LIBCFS_LNET_DIST _IOWR('e', 58, long)
	123	#define IOC_LIBCFS_CONFIGURE _IOWR('e', 59, long)
	124	#define IOC_LIBCFS_TESTPROTOCOMPAT _IOWR('e', 60, long)
	125	#define IOC_LIBCFS_PING _IOWR('e', 61, long)
	126	#define IOC_LIBCFS_DEBUG_PEER _IOWR('e', 62, long)
	127	#define IOC_LIBCFS_LNETST _IOWR('e', 63, long)
d7e09d03	128	/* lnd ioctls */
6be96847 PT	129	#define IOC_LIBCFS_REGISTER_MYNID _IOWR('e', 70, long)
	130	#define IOC_LIBCFS_CLOSE_CONNECTION _IOWR('e', 71, long)
	131	#define IOC_LIBCFS_PUSH_CONNECTION _IOWR('e', 72, long)
	132	#define IOC_LIBCFS_GET_CONN _IOWR('e', 73, long)
	133	#define IOC_LIBCFS_DEL_PEER _IOWR('e', 74, long)
	134	#define IOC_LIBCFS_ADD_PEER _IOWR('e', 75, long)
	135	#define IOC_LIBCFS_GET_PEER _IOWR('e', 76, long)
f57081a5	136	/* ioctl 77 is free for use */
6be96847 PT	137	#define IOC_LIBCFS_ADD_INTERFACE _IOWR('e', 78, long)
	138	#define IOC_LIBCFS_DEL_INTERFACE _IOWR('e', 79, long)
	139	#define IOC_LIBCFS_GET_INTERFACE _IOWR('e', 80, long)
d7e09d03 PT	140
	141	#define IOC_LIBCFS_MAX_NR 80
	142
	143	static inline int libcfs_ioctl_packlen(struct libcfs_ioctl_data *data)
	144	{
	145	int len = sizeof(*data);
a393fd54	146
d7e09d03 PT	147	len += cfs_size_round(data->ioc_inllen1);
	148	len += cfs_size_round(data->ioc_inllen2);
	149	return len;
	150	}
	151
	152	static inline int libcfs_ioctl_is_invalid(struct libcfs_ioctl_data *data)
	153	{
	154	if (data->ioc_len > (1<<30)) {
a393fd54	155	CERROR("LIBCFS ioctl: ioc_len larger than 1<<30\n");
d7e09d03 PT	156	return 1;
	157	}
	158	if (data->ioc_inllen1 > (1<<30)) {
a393fd54	159	CERROR("LIBCFS ioctl: ioc_inllen1 larger than 1<<30\n");
d7e09d03 PT	160	return 1;
	161	}
	162	if (data->ioc_inllen2 > (1<<30)) {
a393fd54	163	CERROR("LIBCFS ioctl: ioc_inllen2 larger than 1<<30\n");
d7e09d03 PT	164	return 1;
	165	}
	166	if (data->ioc_inlbuf1 && !data->ioc_inllen1) {
a393fd54	167	CERROR("LIBCFS ioctl: inlbuf1 pointer but 0 length\n");
d7e09d03 PT	168	return 1;
	169	}
	170	if (data->ioc_inlbuf2 && !data->ioc_inllen2) {
a393fd54	171	CERROR("LIBCFS ioctl: inlbuf2 pointer but 0 length\n");
d7e09d03 PT	172	return 1;
	173	}
	174	if (data->ioc_pbuf1 && !data->ioc_plen1) {
a393fd54	175	CERROR("LIBCFS ioctl: pbuf1 pointer but 0 length\n");
d7e09d03 PT	176	return 1;
	177	}
	178	if (data->ioc_pbuf2 && !data->ioc_plen2) {
a393fd54	179	CERROR("LIBCFS ioctl: pbuf2 pointer but 0 length\n");
d7e09d03 PT	180	return 1;
	181	}
	182	if (data->ioc_plen1 && !data->ioc_pbuf1) {
a393fd54	183	CERROR("LIBCFS ioctl: plen1 nonzero but no pbuf1 pointer\n");
d7e09d03 PT	184	return 1;
	185	}
	186	if (data->ioc_plen2 && !data->ioc_pbuf2) {
a393fd54	187	CERROR("LIBCFS ioctl: plen2 nonzero but no pbuf2 pointer\n");
d7e09d03 PT	188	return 1;
d7e09d03 PT	189	}
a393fd54 GKH	190	if ((__u32)libcfs_ioctl_packlen(data) != data->ioc_len) {
a393fd54 GKH	191	CERROR("LIBCFS ioctl: packlen != ioc_len\n");
d7e09d03 PT	192	return 1;
	193	}
	194	if (data->ioc_inllen1 &&
	195	data->ioc_bulk[data->ioc_inllen1 - 1] != '\0') {
a393fd54	196	CERROR("LIBCFS ioctl: inlbuf1 not 0 terminated\n");
d7e09d03 PT	197	return 1;
	198	}
	199	if (data->ioc_inllen2 &&
	200	data->ioc_bulk[cfs_size_round(data->ioc_inllen1) +
	201	data->ioc_inllen2 - 1] != '\0') {
a393fd54	202	CERROR("LIBCFS ioctl: inlbuf2 not 0 terminated\n");
d7e09d03 PT	203	return 1;
	204	}
	205	return 0;
	206	}
	207
c0b37b70 AS	208	int libcfs_register_ioctl(struct libcfs_ioctl_handler *hand);
	209	int libcfs_deregister_ioctl(struct libcfs_ioctl_handler *hand);
	210	int libcfs_ioctl_getdata(char buf, char end, void *arg);
	211	int libcfs_ioctl_popdata(void arg, void buf, int size);
d7e09d03	212
d7e09d03	213	#endif /* __LIBCFS_IOCTL_H__ */