src/common/misc/fsck-utils.c File Reference

Implementation of the fsck-utils component. More...

#include <stdio.h>
#include <string.h>
#include <time.h>
#include <unistd.h>
#include <ctype.h>
#include <assert.h>
#include "fsck-utils.h"

Functions
void	set_return_code (int *ret, const int retval)
int	compare_handles (const void *handle1, const void *handle2)
int	PINT_handle_wrangler_display_stranded_handles (const struct PINT_fsck_options *fsck_options, const PVFS_fs_id *cur_fs, const PVFS_credentials *creds)
int	PINT_handle_wrangler_load_handles (const struct PINT_fsck_options *fsck_options, const PVFS_fs_id *cur_fs, const PVFS_credentials *creds)
int	PINT_handle_wrangler_remove_handle (const PVFS_handle *handle, const PVFS_fs_id *cur_fs)
int	PVFS_fsck_initialize (const struct PINT_fsck_options *fsck_options, const PVFS_credentials *creds, const PVFS_fs_id *cur_fs)
int	PVFS_fsck_check_server_configs (const struct PINT_fsck_options *fsck_options, const PVFS_credentials *creds, const PVFS_fs_id *cur_fs)
int	PVFS_fsck_validate_dfile (const struct PINT_fsck_options *fsck_options, const PVFS_handle *handle, const PVFS_fs_id *cur_fs, const PVFS_credentials *creds, PVFS_size *dfiles_total_size)
int	PVFS_fsck_validate_dfile_attr (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *getattr_resp)
int	PVFS_fsck_validate_metafile (const struct PINT_fsck_options *fsck_options, const PVFS_object_ref *obj_ref, const PVFS_sysresp_getattr *attributes, const PVFS_credentials *creds)
int	PVFS_fsck_validate_metafile_attr (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_symlink (const struct PINT_fsck_options *fsck_options, const PVFS_object_ref *obj_ref, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_symlink_attr (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_symlink_target (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_dirdata (const struct PINT_fsck_options *fsck_options, const PVFS_handle *handle, const PVFS_fs_id *cur_fs, const PVFS_credentials *creds)
int	PVFS_fsck_validate_dirdata_attr (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_dir (const struct PINT_fsck_options *fsck_options, const PVFS_object_ref *obj_ref, const PVFS_sysresp_getattr *attributes, const PVFS_credentials *creds, PVFS_dirent *directory_entries)
int	PVFS_fsck_validate_dir_attr (const struct PINT_fsck_options *fsck_options, const PVFS_sysresp_getattr *attributes)
int	PVFS_fsck_validate_dir_ent (const struct PINT_fsck_options *fsck_options, const char *filename)
int	PVFS_fsck_get_attributes (const struct PINT_fsck_options *fsck_options, const PVFS_object_ref *pref, const PVFS_credentials *creds, PVFS_sysresp_getattr *getattr_resp)
int	PVFS_fsck_finalize (const struct PINT_fsck_options *fsck_options, const PVFS_fs_id *cur_fs, const PVFS_credentials *creds)
Variables
PINT_handle_wrangler_handlelist	PINT_handle_wrangler_handlelist

---

Detailed Description

Implementation of the fsck-utils component.

TODO's:

• What action should be taken to recover broken on missing PVFS2 objects? Can we recover pieces and zero out unknown? Can we create missing metadata for data files that are orphaned? Do we automatically move to lost+found directory, and/or allow option to simply remove and delete?
• What needs to be done for extended attributes
• What needs to be done for access control lists (extended attributes & accounts)

Terminology:

• Orphaned bstreams: bstreams with no dfiles/attributes
• Stranded Object: An object exists with no way to get to it
  • Datafile missing metadata
  • Metadata missing directory entry
  • Dirdata missing directory object
• Dangling directory entry: directory entry exists, but object/attributes don't

---

Function Documentation

int compare_handles (  const void *  handle1, const void *  handle2 )  [static]

Compares two handles, for qsort(). Return values: 0  if equal <0  if handle1 less than handle2 >0  if handle1 greater than handle2 Parameters: handle1  handle 1 handle2  handle 2

int PINT_handle_wrangler_display_stranded_handles (  const struct PINT_fsck_options *  fsck_options, const PVFS_fs_id *  cur_fs, const PVFS_credentials *  creds )  [static]

Displays the handles left over from the fsck. Return values: 0  on success -PVFS_error  on failure Parameters: fsck_options  populated fsck options cur_fs  filesystem id creds  populated credentials structure

Here is the call graph for this function:

int PINT_handle_wrangler_load_handles (  const struct PINT_fsck_options *  fsck_options, const PVFS_fs_id *  cur_fs, const PVFS_credentials *  creds )  [static]

Gets a list of all the handles used from the PVFS2 servers. The PVFS2 system interface must have already been initialized. Return values: 0  on success -PVFS_error  on failure Parameters: fsck_options  Populated options cur_fs  fs_id creds  populdated credentials structure

Here is the call graph for this function:

int PINT_handle_wrangler_remove_handle (  const PVFS_handle *  handle, const PVFS_fs_id *  cur_fs )  [static]

Removes the given handle from the list of handles stored. Each check in the fsck calls this function as it sees a handle. The end result is a list of left over "stranded" handles. Return values: 0  on success -PVFS_error  on failure Parameters: handle  handle to remove cur_fs  fs_id

Here is the call graph for this function:

void set_return_code (  int *  ret, const int  retval )  [static]

Set the return code for a function, taking previous return values into account. The purpose of this is to make sure when we are propigating errors that warnings do not take precident over standard error codes. Parameters: ret  error code to populate retval  the value we are proposing to set the error code to

---

Variable Documentation

struct PINT_handle_wrangler_handlelist PINT_handle_wrangler_handlelist

The following declarations deal with the option to check for stranded objects.

---