9p: Documentation updates (ee443996) · Commits · e / devices / android_kernel_teracube_2e

fs/9p/fid.h

+15 −0

Original line number	Diff line number	Diff line
		@@ -22,6 +22,21 @@

		#include <linux/list.h>

		/**
		* struct v9fs_dentry - 9p private data stored in dentry d_fsdata
		* @lock: protects the fidlist
		* @fidlist: list of FIDs currently associated with this dentry
		*
		* This structure defines the 9p private data associated with
		* a particular dentry. In particular, this private data is used
		* to lookup which 9P FID handle should be used for a particular VFS
		* operation. FID handles are associated with dentries instead of
		* inodes in order to more closely map functionality to the Plan 9
		* expected behavior for FID reclaimation and tracking.
		*
		* See Also: Mapping FIDs to Linux VFS model in
		* Design and Implementation of the Linux 9P File System documentation
		*/
		struct v9fs_dentry {
		spinlock_t lock; /* protect fidlist */
		struct list_head fidlist;

fs/9p/v9fs.c

+5 −3

Original line number	Diff line number	Diff line
		@@ -71,7 +71,6 @@ static match_table_t tokens = {

		/**
		* v9fs_parse_options - parse mount options into session structure
		* @options: options string passed from mount
		* @v9ses: existing v9fs session information
		*
		*/
		@@ -256,9 +255,12 @@ void v9fs_session_close(struct v9fs_session_info *v9ses)
		}

		/**
		* v9fs_session_cancel - mark transport as disconnected
		* and cancel all pending requests.
		* v9fs_session_cancel - terminate a session
		* @v9ses: session to terminate
		*
		* mark transport as disconnected and cancel all pending requests.
		*/

		void v9fs_session_cancel(struct v9fs_session_info *v9ses) {
		P9_DPRINTK(P9_DEBUG_ERROR, "cancel session %p\n", v9ses);
		p9_client_disconnect(v9ses->clnt);

fs/9p/v9fs.h

+60 −25

Original line number	Diff line number	Diff line
		@@ -21,18 +21,69 @@
		*
		*/

		/*
		* Session structure provides information for an opened session
		/**
		* enum p9_session_flags - option flags for each 9P session
		* @V9FS_EXTENDED: whether or not to use 9P2000.u extensions
		* @V9FS_ACCESS_SINGLE: only the mounting user can access the hierarchy
		* @V9FS_ACCESS_USER: a new attach will be issued for every user (default)
		* @V9FS_ACCESS_ANY: use a single attach for all users
		* @V9FS_ACCESS_MASK: bit mask of different ACCESS options
		*
		* Session flags reflect options selected by users at mount time
		*/
		enum p9_session_flags {
		V9FS_EXTENDED = 0x01,
		V9FS_ACCESS_SINGLE = 0x02,
		V9FS_ACCESS_USER = 0x04,
		V9FS_ACCESS_ANY = 0x06,
		V9FS_ACCESS_MASK = 0x06,
		};

		/* possible values of ->cache */
		/**
		* enum p9_cache_modes - user specified cache preferences
		* @CACHE_NONE: do not cache data, dentries, or directory contents (default)
		* @CACHE_LOOSE: cache data, dentries, and directory contents w/no consistency
		*
		* eventually support loose, tight, time, session, default always none
		*/

		enum p9_cache_modes {
		CACHE_NONE,
		CACHE_LOOSE,
		};

		/**
		* struct v9fs_session_info - per-instance session information
		* @flags: session options of type &p9_session_flags
		* @nodev: set to 1 to disable device mapping
		* @debug: debug level
		* @afid: authentication handle
		* @cache: cache mode of type &p9_cache_modes
		* @options: copy of options string given by user
		* @uname: string user name to mount hierarchy as
		* @aname: mount specifier for remote hierarchy
		* @maxdata: maximum data to be sent/recvd per protocol message
		* @dfltuid: default numeric userid to mount hierarchy as
		* @dfltgid: default numeric groupid to mount hierarchy as
		* @uid: if %V9FS_ACCESS_SINGLE, the numeric uid which mounted the hierarchy
		* @clnt: reference to 9P network client instantiated for this session
		* @debugfs_dir: reference to debugfs_dir which can be used for add'l debug
		*
		* This structure holds state for each session instance established during
		* a sys_mount() .
		*
		* Bugs: there seems to be a lot of state which could be condensed and/or
		* removed.
		*/

		struct v9fs_session_info {
		/* options */
		unsigned char flags; /* session flags */
		unsigned char nodev; /* set to 1 if no disable device mapping */
		unsigned short debug; /* debug level */
		unsigned int afid; /* authentication fid */
		unsigned int cache; /* cache mode */
		unsigned char flags;
		unsigned char nodev;
		unsigned short debug;
		unsigned int afid;
		unsigned int cache;

		char options; / copy of mount options */
		char uname; / user name to mount as */
		@@ -45,22 +96,6 @@ struct v9fs_session_info {
		struct dentry *debugfs_dir;
		};

		/* session flags */
		enum {
		V9FS_EXTENDED = 0x01, /* 9P2000.u */
		V9FS_ACCESS_MASK = 0x06, /* access mask */
		V9FS_ACCESS_SINGLE = 0x02, /* only one user can access the files */
		V9FS_ACCESS_USER = 0x04, /* attache per user */
		V9FS_ACCESS_ANY = 0x06, /* use the same attach for all users */
		};

		/* possible values of ->cache */
		/* eventually support loose, tight, time, session, default always none */
		enum {
		CACHE_NONE, /* default */
		CACHE_LOOSE, /* no consistency */
		};

		extern struct dentry *v9fs_debugfs_root;

		struct p9_fid v9fs_session_init(struct v9fs_session_info , const char *,

fs/9p/vfs_addr.c

+1 −1

Original line number	Diff line number	Diff line
		@@ -43,7 +43,7 @@
		/**
		* v9fs_vfs_readpage - read an entire page in from 9P
		*
		* @file: file being read
		* @filp: file being read
		* @page: structure to page
		*
		*/

fs/9p/vfs_dir.c

+1 −1

Original line number	Diff line number	Diff line
		@@ -60,7 +60,7 @@ static inline int dt_type(struct p9_stat *mistat)

		/**
		* v9fs_dir_readdir - read a directory
		* @filep: opened file structure
		* @filp: opened file structure
		* @dirent: directory structure ???
		* @filldir: function to populate directory structure ???
		*