[net-next-2.6.git] / include / net / 9p / client.h

/*
 * include/net/9p/client.h
 *
 * 9P Client Definitions
 *
 *  Copyright (C) 2008 by Eric Van Hensbergen <ericvh@gmail.com>
 *  Copyright (C) 2007 by Latchesar Ionkov <lucho@ionkov.net>
 *
 *  This program is free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License version 2
 *  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 for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to:
 *  Free Software Foundation
 *  51 Franklin Street, Fifth Floor
 *  Boston, MA  02111-1301  USA
 *
 */

#ifndef NET_9P_CLIENT_H
#define NET_9P_CLIENT_H

/* Number of requests per row */
#define P9_ROW_MAXTAG 255

/** enum p9_proto_versions - 9P protocol versions
 * @p9_proto_legacy: 9P Legacy mode, pre-9P2000.u
 * @p9_proto_2000u: 9P2000.u extension
 * @p9_proto_2000L: 9P2000.L extension
 */

enum p9_proto_versions{
	p9_proto_legacy = 0,
	p9_proto_2000u = 1,
	p9_proto_2000L = 2,
};


/**
 * enum p9_trans_status - different states of underlying transports
 * @Connected: transport is connected and healthy
 * @Disconnected: transport has been disconnected
 * @Hung: transport is connected by wedged
 *
 * This enumeration details the various states a transport
 * instatiation can be in.
 */

enum p9_trans_status {
	Connected,
	BeginDisconnect,
	Disconnected,
	Hung,
};

/**
 * enum p9_req_status_t - virtio request status
 * @REQ_STATUS_IDLE: request slot unused
 * @REQ_STATUS_ALLOC: request has been allocated but not sent
 * @REQ_STATUS_UNSENT: request waiting to be sent
 * @REQ_STATUS_SENT: request sent to server
 * @REQ_STATUS_FLSH: a flush has been sent for this request
 * @REQ_STATUS_RCVD: response received from server
 * @REQ_STATUS_FLSHD: request has been flushed
 * @REQ_STATUS_ERROR: request encountered an error on the client side
 *
 * The @REQ_STATUS_IDLE state is used to mark a request slot as unused
 * but use is actually tracked by the idpool structure which handles tag
 * id allocation.
 *
 */

enum p9_req_status_t {
	REQ_STATUS_IDLE,
	REQ_STATUS_ALLOC,
	REQ_STATUS_UNSENT,
	REQ_STATUS_SENT,
	REQ_STATUS_FLSH,
	REQ_STATUS_RCVD,
	REQ_STATUS_FLSHD,
	REQ_STATUS_ERROR,
};

/**
 * struct p9_req_t - request slots
 * @status: status of this request slot
 * @t_err: transport error
 * @flush_tag: tag of request being flushed (for flush requests)
 * @wq: wait_queue for the client to block on for this request
 * @tc: the request fcall structure
 * @rc: the response fcall structure
 * @aux: transport specific data (provided for trans_fd migration)
 * @req_list: link for higher level objects to chain requests
 *
 * Transport use an array to track outstanding requests
 * instead of a list.  While this may incurr overhead during initial
 * allocation or expansion, it makes request lookup much easier as the
 * tag id is a index into an array.  (We use tag+1 so that we can accomodate
 * the -1 tag for the T_VERSION request).
 * This also has the nice effect of only having to allocate wait_queues
 * once, instead of constantly allocating and freeing them.  Its possible
 * other resources could benefit from this scheme as well.
 *
 */

struct p9_req_t {
	int status;
	int t_err;
	wait_queue_head_t *wq;
	struct p9_fcall *tc;
	struct p9_fcall *rc;
	void *aux;

	struct list_head req_list;
};

/**
 * struct p9_client - per client instance state
 * @lock: protect @fidlist
 * @msize: maximum data size negotiated by protocol
 * @dotu: extension flags negotiated by protocol
 * @proto_version: 9P protocol version to use
 * @trans_mod: module API instantiated with this client
 * @trans: tranport instance state and API
 * @conn: connection state information used by trans_fd
 * @fidpool: fid handle accounting for session
 * @fidlist: List of active fid handles
 * @tagpool - transaction id accounting for session
 * @reqs - 2D array of requests
 * @max_tag - current maximum tag id allocated
 *
 * The client structure is used to keep track of various per-client
 * state that has been instantiated.
 * In order to minimize per-transaction overhead we use a
 * simple array to lookup requests instead of a hash table
 * or linked list.  In order to support larger number of
 * transactions, we make this a 2D array, allocating new rows
 * when we need to grow the total number of the transactions.
 *
 * Each row is 256 requests and we'll support up to 256 rows for
 * a total of 64k concurrent requests per session.
 *
 * Bugs: duplicated data and potentially unnecessary elements.
 */

struct p9_client {
	spinlock_t lock; /* protect client structure */
	int msize;
	unsigned char proto_version;
	struct p9_trans_module *trans_mod;
	enum p9_trans_status status;
	void *trans;
	struct p9_conn *conn;

	struct p9_idpool *fidpool;
	struct list_head fidlist;

	struct p9_idpool *tagpool;
	struct p9_req_t *reqs[P9_ROW_MAXTAG];
	int max_tag;
};

/**
 * struct p9_fid - file system entity handle
 * @clnt: back pointer to instantiating &p9_client
 * @fid: numeric identifier for this handle
 * @mode: current mode of this fid (enum?)
 * @qid: the &p9_qid server identifier this handle points to
 * @iounit: the server reported maximum transaction size for this file
 * @uid: the numeric uid of the local user who owns this handle
 * @rdir: readdir accounting structure (allocated on demand)
 * @flist: per-client-instance fid tracking
 * @dlist: per-dentry fid tracking
 *
 * TODO: This needs lots of explanation.
 */

struct p9_fid {
	struct p9_client *clnt;
	u32 fid;
	int mode;
	struct p9_qid qid;
	u32 iounit;
	uid_t uid;

	void *rdir;

	struct list_head flist;
	struct list_head dlist;	/* list of all fids attached to a dentry */
};

/**
 * struct p9_dirent - directory entry structure
 * @qid: The p9 server qid for this dirent
 * @d_off: offset to the next dirent
 * @d_type: type of file
 * @d_name: file name
 */

struct p9_dirent {
	struct p9_qid qid;
	u64 d_off;
	unsigned char d_type;
	char d_name[256];
};

int p9_client_statfs(struct p9_fid *fid, struct p9_rstatfs *sb);
int p9_client_rename(struct p9_fid *fid, struct p9_fid *newdirfid, char *name);
struct p9_client *p9_client_create(const char *dev_name, char *options);
void p9_client_destroy(struct p9_client *clnt);
void p9_client_disconnect(struct p9_client *clnt);
void p9_client_begin_disconnect(struct p9_client *clnt);
struct p9_fid *p9_client_attach(struct p9_client *clnt, struct p9_fid *afid,
					char *uname, u32 n_uname, char *aname);
struct p9_fid *p9_client_walk(struct p9_fid *oldfid, int nwname, char **wnames,
								int clone);
int p9_client_open(struct p9_fid *fid, int mode);
int p9_client_fcreate(struct p9_fid *fid, char *name, u32 perm, int mode,
							char *extension);
int p9_client_link(struct p9_fid *fid, struct p9_fid *oldfid, char *newname);
int p9_client_symlink(struct p9_fid *fid, char *name, char *symname, gid_t gid,
							struct p9_qid *qid);
int p9_client_create_dotl(struct p9_fid *ofid, char *name, u32 flags, u32 mode,
		gid_t gid, struct p9_qid *qid);
int p9_client_clunk(struct p9_fid *fid);
int p9_client_remove(struct p9_fid *fid);
int p9_client_read(struct p9_fid *fid, char *data, char __user *udata,
							u64 offset, u32 count);
int p9_client_write(struct p9_fid *fid, char *data, const char __user *udata,
							u64 offset, u32 count);
int p9_client_readdir(struct p9_fid *fid, char *data, u32 count, u64 offset);
int p9dirent_read(char *buf, int len, struct p9_dirent *dirent,
							int proto_version);
struct p9_wstat *p9_client_stat(struct p9_fid *fid);
int p9_client_wstat(struct p9_fid *fid, struct p9_wstat *wst);
int p9_client_setattr(struct p9_fid *fid, struct p9_iattr_dotl *attr);

struct p9_stat_dotl *p9_client_getattr_dotl(struct p9_fid *fid,
							u64 request_mask);

int p9_client_mknod_dotl(struct p9_fid *oldfid, char *name, int mode,
			dev_t rdev, gid_t gid, struct p9_qid *);
int p9_client_mkdir_dotl(struct p9_fid *fid, char *name, int mode,
				gid_t gid, struct p9_qid *);
struct p9_req_t *p9_tag_lookup(struct p9_client *, u16);
void p9_client_cb(struct p9_client *c, struct p9_req_t *req);

int p9_parse_header(struct p9_fcall *, int32_t *, int8_t *, int16_t *, int);
int p9stat_read(char *, int, struct p9_wstat *, int);
void p9stat_free(struct p9_wstat *);

int p9_is_proto_dotu(struct p9_client *clnt);
int p9_is_proto_dotl(struct p9_client *clnt);
struct p9_fid *p9_client_xattrwalk(struct p9_fid *, const char *, u64 *);
int p9_client_xattrcreate(struct p9_fid *, const char *, u64, int);

#endif /* NET_9P_CLIENT_H */
Commit	Line	Data
bd238fb4 LI	1	/*
	2	* include/net/9p/client.h
	3	*
	4	* 9P Client Definitions
	5	*
8a0dc95f	6	* Copyright (C) 2008 by Eric Van Hensbergen <ericvh@gmail.com>
bd238fb4 LI	7	* Copyright (C) 2007 by Latchesar Ionkov <lucho@ionkov.net>
	8	*
	9	* This program is free software; you can redistribute it and/or modify
	10	* it under the terms of the GNU General Public License version 2
	11	* as published by the Free Software Foundation.
	12	*
	13	* This program is distributed in the hope that it will be useful,
	14	* but WITHOUT ANY WARRANTY; without even the implied warranty of
	15	* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
	16	* GNU General Public License for more details.
	17	*
	18	* You should have received a copy of the GNU General Public License
	19	* along with this program; if not, write to:
	20	* Free Software Foundation
	21	* 51 Franklin Street, Fifth Floor
	22	* Boston, MA 02111-1301 USA
	23	*
	24	*/
	25
	26	#ifndef NET_9P_CLIENT_H
	27	#define NET_9P_CLIENT_H
	28
fea511a6 EVH	29	/* Number of requests per row */
	30	#define P9_ROW_MAXTAG 255
	31
0fb80abd SK	32	/** enum p9_proto_versions - 9P protocol versions
	33	* @p9_proto_legacy: 9P Legacy mode, pre-9P2000.u
	34	* @p9_proto_2000u: 9P2000.u extension
45bc21ed	35	* @p9_proto_2000L: 9P2000.L extension
0fb80abd SK	36	*/
	37
	38	enum p9_proto_versions{
	39	p9_proto_legacy = 0,
	40	p9_proto_2000u = 1,
45bc21ed	41	p9_proto_2000L = 2,
0fb80abd SK	42	};
	43
	44
8b81ef58 EVH	45	/**
	46	* enum p9_trans_status - different states of underlying transports
	47	* @Connected: transport is connected and healthy
	48	* @Disconnected: transport has been disconnected
	49	* @Hung: transport is connected by wedged
	50	*
	51	* This enumeration details the various states a transport
	52	* instatiation can be in.
	53	*/
	54
	55	enum p9_trans_status {
	56	Connected,
6d96d3ab	57	BeginDisconnect,
8b81ef58 EVH	58	Disconnected,
	59	Hung,
	60	};
	61
fea511a6 EVH	62	/**
	63	* enum p9_req_status_t - virtio request status
	64	* @REQ_STATUS_IDLE: request slot unused
	65	* @REQ_STATUS_ALLOC: request has been allocated but not sent
673d62cd	66	* @REQ_STATUS_UNSENT: request waiting to be sent
fea511a6 EVH	67	* @REQ_STATUS_SENT: request sent to server
	68	* @REQ_STATUS_FLSH: a flush has been sent for this request
	69	* @REQ_STATUS_RCVD: response received from server
	70	* @REQ_STATUS_FLSHD: request has been flushed
673d62cd	71	* @REQ_STATUS_ERROR: request encountered an error on the client side
fea511a6 EVH	72	*
	73	* The @REQ_STATUS_IDLE state is used to mark a request slot as unused
	74	* but use is actually tracked by the idpool structure which handles tag
	75	* id allocation.
	76	*
	77	*/
	78
	79	enum p9_req_status_t {
	80	REQ_STATUS_IDLE,
	81	REQ_STATUS_ALLOC,
673d62cd	82	REQ_STATUS_UNSENT,
fea511a6 EVH	83	REQ_STATUS_SENT,
	84	REQ_STATUS_FLSH,
	85	REQ_STATUS_RCVD,
	86	REQ_STATUS_FLSHD,
	87	REQ_STATUS_ERROR,
	88	};
	89
	90	/**
	91	* struct p9_req_t - request slots
	92	* @status: status of this request slot
	93	* @t_err: transport error
51a87c55	94	* @flush_tag: tag of request being flushed (for flush requests)
fea511a6 EVH	95	* @wq: wait_queue for the client to block on for this request
	96	* @tc: the request fcall structure
	97	* @rc: the response fcall structure
	98	* @aux: transport specific data (provided for trans_fd migration)
673d62cd	99	* @req_list: link for higher level objects to chain requests
fea511a6 EVH	100	*
	101	* Transport use an array to track outstanding requests
	102	* instead of a list. While this may incurr overhead during initial
	103	* allocation or expansion, it makes request lookup much easier as the
	104	* tag id is a index into an array. (We use tag+1 so that we can accomodate
	105	* the -1 tag for the T_VERSION request).
	106	* This also has the nice effect of only having to allocate wait_queues
	107	* once, instead of constantly allocating and freeing them. Its possible
	108	* other resources could benefit from this scheme as well.
	109	*
	110	*/
	111
	112	struct p9_req_t {
	113	int status;
	114	int t_err;
	115	wait_queue_head_t *wq;
	116	struct p9_fcall *tc;
	117	struct p9_fcall *rc;
fea511a6	118	void *aux;
673d62cd	119
673d62cd	120	struct list_head req_list;
fea511a6 EVH	121	};
fea511a6 EVH	122
ee443996 EVH	123	/**
	124	* struct p9_client - per client instance state
	125	* @lock: protect @fidlist
	126	* @msize: maximum data size negotiated by protocol
	127	* @dotu: extension flags negotiated by protocol
0fb80abd	128	* @proto_version: 9P protocol version to use
ee443996 EVH	129	* @trans_mod: module API instantiated with this client
	130	* @trans: tranport instance state and API
	131	* @conn: connection state information used by trans_fd
	132	* @fidpool: fid handle accounting for session
	133	* @fidlist: List of active fid handles
fea511a6 EVH	134	* @tagpool - transaction id accounting for session
	135	* @reqs - 2D array of requests
	136	* @max_tag - current maximum tag id allocated
ee443996 EVH	137	*
	138	* The client structure is used to keep track of various per-client
	139	* state that has been instantiated.
fea511a6 EVH	140	* In order to minimize per-transaction overhead we use a
	141	* simple array to lookup requests instead of a hash table
	142	* or linked list. In order to support larger number of
	143	* transactions, we make this a 2D array, allocating new rows
	144	* when we need to grow the total number of the transactions.
	145	*
	146	* Each row is 256 requests and we'll support up to 256 rows for
	147	* a total of 64k concurrent requests per session.
ee443996 EVH	148	*
	149	* Bugs: duplicated data and potentially unnecessary elements.
	150	*/
	151
bd238fb4 LI	152	struct p9_client {
	153	spinlock_t lock; /* protect client structure */
	154	int msize;
0fb80abd	155	unsigned char proto_version;
8a0dc95f	156	struct p9_trans_module *trans_mod;
8b81ef58 EVH	157	enum p9_trans_status status;
8b81ef58 EVH	158	void *trans;
bd238fb4 LI	159	struct p9_conn *conn;
	160
	161	struct p9_idpool *fidpool;
	162	struct list_head fidlist;
fea511a6 EVH	163
	164	struct p9_idpool *tagpool;
	165	struct p9_req_t *reqs[P9_ROW_MAXTAG];
	166	int max_tag;
bd238fb4 LI	167	};
bd238fb4 LI	168
ee443996 EVH	169	/**
	170	* struct p9_fid - file system entity handle
	171	* @clnt: back pointer to instantiating &p9_client
	172	* @fid: numeric identifier for this handle
	173	* @mode: current mode of this fid (enum?)
	174	* @qid: the &p9_qid server identifier this handle points to
	175	* @iounit: the server reported maximum transaction size for this file
	176	* @uid: the numeric uid of the local user who owns this handle
3e2796a9	177	* @rdir: readdir accounting structure (allocated on demand)
ee443996 EVH	178	* @flist: per-client-instance fid tracking
	179	* @dlist: per-dentry fid tracking
	180	*
	181	* TODO: This needs lots of explanation.
	182	*/
	183
bd238fb4 LI	184	struct p9_fid {
	185	struct p9_client *clnt;
	186	u32 fid;
	187	int mode;
	188	struct p9_qid qid;
	189	u32 iounit;
	190	uid_t uid;
bd238fb4	191
3e2796a9 EVH	192	void *rdir;
3e2796a9 EVH	193
bd238fb4 LI	194	struct list_head flist;
	195	struct list_head dlist; /* list of all fids attached to a dentry */
	196	};
	197
7751bdb3 SK	198	/**
	199	* struct p9_dirent - directory entry structure
	200	* @qid: The p9 server qid for this dirent
	201	* @d_off: offset to the next dirent
	202	* @d_type: type of file
	203	* @d_name: file name
	204	*/
	205
	206	struct p9_dirent {
	207	struct p9_qid qid;
	208	u64 d_off;
	209	unsigned char d_type;
	210	char d_name[256];
	211	};
	212
bda8e775	213	int p9_client_statfs(struct p9_fid fid, struct p9_rstatfs sb);
4681dbda	214	int p9_client_rename(struct p9_fid fid, struct p9_fid newdirfid, char *name);
8a0dc95f	215	struct p9_client p9_client_create(const char dev_name, char *options);
bd238fb4 LI	216	void p9_client_destroy(struct p9_client *clnt);
bd238fb4 LI	217	void p9_client_disconnect(struct p9_client *clnt);
6d96d3ab	218	void p9_client_begin_disconnect(struct p9_client *clnt);
bd238fb4	219	struct p9_fid p9_client_attach(struct p9_client clnt, struct p9_fid *afid,
ba17674f	220	char uname, u32 n_uname, char aname);
bd238fb4 LI	221	struct p9_fid p9_client_walk(struct p9_fid oldfid, int nwname, char **wnames,
	222	int clone);
	223	int p9_client_open(struct p9_fid *fid, int mode);
	224	int p9_client_fcreate(struct p9_fid fid, char name, u32 perm, int mode,
	225	char *extension);
652df9a7	226	int p9_client_link(struct p9_fid fid, struct p9_fid oldfid, char *newname);
50cc42ff VJJ	227	int p9_client_symlink(struct p9_fid fid, char name, char *symname, gid_t gid,
50cc42ff VJJ	228	struct p9_qid *qid);
5643135a VJJ	229	int p9_client_create_dotl(struct p9_fid ofid, char name, u32 flags, u32 mode,
5643135a VJJ	230	gid_t gid, struct p9_qid *qid);
bd238fb4 LI	231	int p9_client_clunk(struct p9_fid *fid);
bd238fb4 LI	232	int p9_client_remove(struct p9_fid *fid);
0fc9655e EVH	233	int p9_client_read(struct p9_fid fid, char data, char __user *udata,
0fc9655e EVH	234	u64 offset, u32 count);
0fc9655e EVH	235	int p9_client_write(struct p9_fid fid, char data, const char __user *udata,
0fc9655e EVH	236	u64 offset, u32 count);
7751bdb3 SK	237	int p9_client_readdir(struct p9_fid fid, char data, u32 count, u64 offset);
	238	int p9dirent_read(char buf, int len, struct p9_dirent dirent,
	239	int proto_version);
51a87c55	240	struct p9_wstat p9_client_stat(struct p9_fid fid);
bd238fb4	241	int p9_client_wstat(struct p9_fid fid, struct p9_wstat wst);
87d7845a	242	int p9_client_setattr(struct p9_fid fid, struct p9_iattr_dotl attr);
bd238fb4	243
f0853122 SK	244	struct p9_stat_dotl p9_client_getattr_dotl(struct p9_fid fid,
	245	u64 request_mask);
	246
4b43516a MK	247	int p9_client_mknod_dotl(struct p9_fid oldfid, char name, int mode,
4b43516a MK	248	dev_t rdev, gid_t gid, struct p9_qid *);
01a622bd MK	249	int p9_client_mkdir_dotl(struct p9_fid fid, char name, int mode,
01a622bd MK	250	gid_t gid, struct p9_qid *);
fea511a6	251	struct p9_req_t p9_tag_lookup(struct p9_client , u16);
91b8534f	252	void p9_client_cb(struct p9_client c, struct p9_req_t req);
fea511a6	253
fc79d4b1	254	int p9_parse_header(struct p9_fcall , int32_t , int8_t , int16_t , int);
02da398b	255	int p9stat_read(char , int, struct p9_wstat , int);
51a87c55 EVH	256	void p9stat_free(struct p9_wstat *);
51a87c55 EVH	257
342fee1d SK	258	int p9_is_proto_dotu(struct p9_client *clnt);
342fee1d SK	259	int p9_is_proto_dotl(struct p9_client *clnt);
0ef63f34	260	struct p9_fid p9_client_xattrwalk(struct p9_fid , const char , u64 );
eda25e46	261	int p9_client_xattrcreate(struct p9_fid , const char , u64, int);
02da398b	262
bd238fb4	263	#endif /* NET_9P_CLIENT_H */