fsal_lookup.c File Reference

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

Go to the source code of this file.

Functions
fsal_status_t	POSIXFSAL_lookup (fsal_handle_t *parent_directory_handle, fsal_name_t *p_filename, fsal_op_context_t *context, fsal_handle_t *object_handle, fsal_attrib_list_t *p_object_attributes)
fsal_status_t	POSIXFSAL_lookupPath (fsal_path_t *p_path, fsal_op_context_t *context, fsal_handle_t *object_hdl, fsal_attrib_list_t *object_attributes)
fsal_status_t	POSIXFSAL_lookupJunction (fsal_handle_t *p_junction_handle, fsal_op_context_t *p_context, fsal_handle_t *p_fsoot_handle, fsal_attrib_list_t *p_fsroot_attributes)

---

Function Documentation

fsal_status_t POSIXFSAL_lookup	(	fsal_handle_t *	parent_directory_handle,
		fsal_name_t *	p_filename,
		fsal_op_context_t *	context,
		fsal_handle_t *	object_handle,
		fsal_attrib_list_t *	p_object_attributes
	)

FSAL_lookup : Looks up for an object into a directory.

Note : if parent handle and filename are NULL, this retrieves root's handle.

Parameters:

parent_directory_handle	(input) Handle of the parent directory to search the object in.
filename	(input) The name of the object to find.
p_context	(input) Authentication context for the operation (user,...).
object_handle	(output) The handle of the object corresponding to filename.
object_attributes	(optional input/output) Pointer to the attributes of the object we found. As input, it defines the attributes that the caller wants to retrieve (by positioning flags into this structure) and the output is built considering this input (it fills the structure according to the flags it contains). It can be NULL (increases performances).

Returns:

- ERR_FSAL_NO_ERROR, if no error.

• Another error code else.

Definition at line 49 of file FSAL_POSIX/fsal_lookup.c.

fsal_status_t POSIXFSAL_lookupJunction	(	fsal_handle_t *	p_junction_handle,
		fsal_op_context_t *	p_context,
		fsal_handle_t *	p_fsoot_handle,
		fsal_attrib_list_t *	p_fsroot_attributes
	)

FSAL_lookupJunction : Get the fileset root for a junction.

Parameters:

p_junction_handle	(input) Handle of the junction to be looked up.
p_context	(input) Authentication context for the operation (user,...).
p_fsroot_handle	(output) The handle of root directory of the fileset.
p_fsroot_attributes	(optional input/output) Pointer to the attributes of the root directory for the fileset. As input, it defines the attributes that the caller wants to retrieve (by positioning flags into this structure) and the output is built considering this input (it fills the structure according to the flags it contains). It can be NULL (increases performances).

Returns:

- ERR_FSAL_NO_ERROR, if no error.

• Another error code else.

Definition at line 363 of file FSAL_POSIX/fsal_lookup.c.

fsal_status_t POSIXFSAL_lookupPath	(	fsal_path_t *	p_path,
		fsal_op_context_t *	context,
		fsal_handle_t *	object_hdl,
		fsal_attrib_list_t *	object_attributes
	)

FSAL_lookupPath : Looks up for an object into the namespace.

Note : if path equals "/", this retrieves root's handle.

Parameters:

path	(input) The path of the object to find.
p_context	(input) Authentication context for the operation (user,...).
object_handle	(output) The handle of the object corresponding to filename.
object_attributes	(optional input/output) Pointer to the attributes of the object we found. As input, it defines the attributes that the caller wants to retrieve (by positioning flags into this structure) and the output is built considering this input (it fills the structure according to the flags it contains). It can be NULL (increases performances).

Todo:

: Be carefull about junction crossing, symlinks, hardlinks,...

Definition at line 227 of file FSAL_POSIX/fsal_lookup.c.