NFS client. More...

Enumerations

Functions
struct nfs_client *	nfs_mount (struct ip_addr server, const char path, nfs_mount_callback_t callback, void cbarg)
	Initiate an NFS mount operation. More...

err_t	nfs_getattr (struct nfs_client client, struct nfs_fh3 fh, nfs_getattr_callback_t callback, void cbarg)
	Initiate an NFS getattr operation. More...

err_t	nfs_setattr (struct nfs_client client, struct nfs_fh3 fh, sattr3 new_attributes, bool guarded, nfs_setattr_callback_t callback, void cbarg)
	Initiate an NFS setattr operation. More...

err_t	nfs_readdir (struct nfs_client client, struct nfs_fh3 fh, cookie3 cookie, cookieverf3 cookieverf, nfs_readdir_callback_t callback, void cbarg)
	Initiate an NFS readdir operation. More...

err_t	nfs_readdirplus (struct nfs_client client, struct nfs_fh3 fh, cookie3 cookie, cookieverf3 cookieverf, nfs_readdirplus_callback_t callback, void cbarg)
	Initiate an NFS readdirplus operation. More...

err_t	nfs_lookup (struct nfs_client client, struct nfs_fh3 dirfh, const char name, nfs_lookup_callback_t callback, void *cbarg)
	Initiate an NFS lookup operation. More...

err_t	nfs_access (struct nfs_client client, struct nfs_fh3 fh, uint32_t access, nfs_access_callback_t callback, void cbarg)
	Initiate an NFS access operation. More...

err_t	nfs_read (struct nfs_client client, struct nfs_fh3 fh, offset3 offset, count3 count, nfs_read_callback_t callback, void cbarg)
	Initiate an NFS read operation. More...

err_t	nfs_write (struct nfs_client client, struct nfs_fh3 fh, offset3 offset, const void data, count3 count, stable_how stable, nfs_write_callback_t callback, void *cbarg)
	Initiate an NFS write operation. More...

err_t	nfs_create (struct nfs_client client, struct nfs_fh3 dir, const char name, bool guarded, sattr3 attributes, nfs_create_callback_t callback, void *cbarg)
	Initiate an NFS create operation (unchecked or guarded) More...

err_t	nfs_mkdir (struct nfs_client client, struct nfs_fh3 dir, const char name, sattr3 attributes, nfs_mkdir_callback_t callback, void *cbarg)
	Initiate an NFS mkdir operation. More...

err_t	nfs_remove (struct nfs_client client, struct nfs_fh3 dir, const char name, nfs_remove_callback_t callback, void *cbarg)
	Initiate an NFS remove operation. More...

void	nfs_destroy (struct nfs_client *client)
	Reclaim memory and terminate any outstanding operations.

Detailed Description

NFS client.

Enumeration Type Documentation

enum nfs_mount_state

What state are we at in initialising this mount?

Enumerator
NFS_INIT_GETPORT_MOUNT	consult portmap for mountd port
NFS_INIT_GETPORT_NFS	consult portmap for nfsd port
NFS_INIT_MOUNT	call mountd to perform mount
NFS_INIT_COMPLETE	complete

Function Documentation

err_t nfs_access	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		uint32_t	access,
		nfs_access_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS access operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for file/object to check access to
access	Rights to check for
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_create	(	struct nfs_client *	client,
		struct nfs_fh3	dir,
		const char *	name,
		bool	guarded,
		sattr3	attributes,
		nfs_create_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS create operation (unchecked or guarded)

Parameters

client	NFS client pointer, which has completed the mount process
dir	Filehandle for directory in which to create file
name	Name of file to create
guarded	True iff the operation should fail if the file already exists
attributes	Initial attributes for the file
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_getattr	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		nfs_getattr_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS getattr operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for directory to stat
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_lookup	(	struct nfs_client *	client,
		struct nfs_fh3	dirfh,
		const char *	name,
		nfs_lookup_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS lookup operation.

Parameters

client	NFS client pointer, which has completed the mount process
dirfh	Filehandle for directory to lookup
name	Name to lookup
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_mkdir	(	struct nfs_client *	client,
		struct nfs_fh3	dir,
		const char *	name,
		sattr3	attributes,
		nfs_mkdir_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS mkdir operation.

Parameters

client	NFS client pointer, which has completed the mount process
dir	Filehandle for directory in which to create directory
name	Name of directory to create
attributes	Initial attributes for the directory
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

struct nfs_client* nfs_mount	(	struct ip_addr	server,
		const char *	path,
		nfs_mount_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS mount operation.

Parameters

server	IP address of NFSv3 server
path	Path on server to mount
callback	Callback function to call when mount completes or fails
cbarg	Opaque argument word passed to callback function

Returns: nfs_client instance pointer on success, or NULL on error. If this call succeeds, the returned client instance must be freed by a later call to nfs_destroy().

err_t nfs_read	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		offset3	offset,
		count3	count,
		nfs_read_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS read operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for file to read
offset	Offset from start of file to read from
count	Maximum number of bytes to read
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_readdir	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		cookie3	cookie,
		cookieverf3	cookieverf,
		nfs_readdir_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS readdir operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for directory to read
cookie	Cookie from a previous call, or NFS_READDIR_COOKIE for a new call
cookieverf	Cookie verifier from a previous call, or NFS_READDIR_COOKIEVERF
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_readdirplus	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		cookie3	cookie,
		cookieverf3	cookieverf,
		nfs_readdirplus_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS readdirplus operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for directory to read
cookie	Cookie from a previous call, or NFS_READDIR_COOKIE for a new call
cookieverf	Cookie verifier from a previous call, or NFS_READDIR_COOKIEVERF
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_remove	(	struct nfs_client *	client,
		struct nfs_fh3	dir,
		const char *	name,
		nfs_remove_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS remove operation.

Parameters

client	NFS client pointer, which has completed the mount process
dir	Filehandle for directory in which to remove file
name	Name of file to remove
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_setattr	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		sattr3	new_attributes,
		bool	guarded,
		nfs_setattr_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS setattr operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for directory which attributes are to be modified
new	New attributes for directory
guarded	TODO
ctime	TODO
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

err_t nfs_write	(	struct nfs_client *	client,
		struct nfs_fh3	fh,
		offset3	offset,
		const void *	data,
		count3	count,
		stable_how	stable,
		nfs_write_callback_t	callback,
		void *	cbarg
	)

Initiate an NFS write operation.

Parameters

client	NFS client pointer, which has completed the mount process
fh	Filehandle for file to write
offset	Offset from start of file to write from
data	Pointer to data to write
count	Number of bytes of data to write
stable	Specifies when the server may commit data to stable storage
callback	Callback function to call when operation returns
cbarg	Opaque argument word passed to callback function

Returns: ERR_OK on success, error code on failure

Enumerations

Functions

Detailed Description

Enumeration Type Documentation

Function Documentation