fsal_dirs.c File Reference

#include "fsal.h"
#include "fsal_internal.h"
#include "fsal_convert.h"
#include <string.h>

Go to the source code of this file.

Functions
fsal_status_t	CEPHFSAL_opendir (fsal_handle_t *exthandle, fsal_op_context_t *extcontext, fsal_dir_t *extdescriptor, fsal_attrib_list_t *dir_attributes)
fsal_status_t	CEPHFSAL_readdir (fsal_dir_t *extdescriptor, fsal_cookie_t extstart, fsal_attrib_mask_t attrmask, fsal_mdsize_t buffersize, fsal_dirent_t *dirents, fsal_cookie_t *extend, fsal_count_t *count, fsal_boolean_t *end_of_dir)
fsal_status_t	CEPHFSAL_closedir (fsal_dir_t *extdescriptor)

---

Function Documentation

fsal_status_t CEPHFSAL_closedir

(

fsal_dir_t *

extdescriptor

)

FSAL_closedir : Free the resources allocated for reading directory entries.

Parameters:

dir_descriptor

(input): Pointer to a directory descriptor filled by FSAL_opendir.

Returns:

Major error codes :

• ERR_FSAL_NO_ERROR (no error)
• ERR_FSAL_FAULT (a NULL pointer was passed as mandatory argument)
• Other error codes can be returned : ERR_FSAL_IO, ...

Definition at line 254 of file FSAL_CEPH/fsal_dirs.c.

fsal_status_t CEPHFSAL_opendir	(	fsal_handle_t *	exthandle,
		fsal_op_context_t *	extcontext,
		fsal_dir_t *	extdescriptor,
		fsal_attrib_list_t *	dir_attributes
	)

FSAL_opendir : Opens a directory for reading its content.

Parameters:

exthandle	(input) the handle of the directory to be opened.
extcontext	(input) Permission context for the operation (user, export context...).
extdescriptor	(output) pointer to an allocated structure that will receive directory stream informations, on successfull completion.
attributes	(optional output) On successfull completion,the structure pointed by dir_attributes receives the new directory attributes. Can be NULL.

Returns:

Major error codes :

• ERR_FSAL_NO_ERROR (no error)
• ERR_FSAL_ACCESS (user does not have read permission on directory)
• ERR_FSAL_STALE (exthandle does not address an existing object)
• ERR_FSAL_FAULT (a NULL pointer was passed as mandatory argument)
• Other error codes can be returned : ERR_FSAL_IO, ...

Definition at line 68 of file FSAL_CEPH/fsal_dirs.c.

fsal_status_t CEPHFSAL_readdir	(	fsal_dir_t *	extdescriptor,
		fsal_cookie_t	extstart,
		fsal_attrib_mask_t	attrmask,
		fsal_mdsize_t	buffersize,
		fsal_dirent_t *	dirents,
		fsal_cookie_t *	extend,
		fsal_count_t *	count,
		fsal_boolean_t *	end_of_dir
	)

FSAL_readdir : Read the entries of an opened directory.

Parameters:

descriptor	(input): Pointer to the directory descriptor filled by FSAL_opendir.
start_position	(input): Cookie that indicates the first object to be read during this readdir operation. This should be : FSAL_READDIR_FROM_BEGINNING for reading the content of the directory from the beginning. The end_position parameter returned by the previous call to FSAL_readdir.
get_attr_mask	(input) Specify the set of attributes to be retrieved for directory entries.
buffersize	(input) The size (in bytes) of the buffer where the direntries are to be stored.
dirents	(output) Adress of the buffer where the direntries are to be stored.
end_position	(output) Cookie that indicates the current position in the directory.
count	(output) Pointer to the number of entries read during the call.
end_of_dir	(output) Pointer to a boolean that indicates if the end of dir has been reached during the call.

Returns:

Major error codes :

• ERR_FSAL_NO_ERROR (no error)
• ERR_FSAL_FAULT (a NULL pointer was passed as mandatory argument)
• Other error codes can be returned : ERR_FSAL_IO, ...

Definition at line 151 of file FSAL_CEPH/fsal_dirs.c.