PVFS2 Validate

The pvfs2-validate implementation provides a client side utility to find and repair PVFS2 file system problems. More...

Files
file	pvfs2-validate.c
Functions
int	validate_pvfs_object (const struct PINT_fsck_options *fsck_options, const PVFS_object_ref *pref, const PVFS_credentials *creds, int *cur_fs, char *current_path)

---

Detailed Description

The pvfs2-validate implementation provides a client side utility to find and repair PVFS2 file system problems.

See also:

fsckutils

Before running pvfs2-validate, the following requirements must be met:

• The PVFS2 servers must be running
• No clients should be accssing the file system

TODO:

• Need to design a way to kick off process on the pvfs2-server to check for orphaned bstreams (bstreams with no attributes and/or dfiles)
• Needs to enter admin mode in beginning if needed, and leave at end. Shouldn't leave admin mode during operation.
• Add ability to run pvfs2-validate on an unmounted filesytem, and on a system with no entries in tabfiles (pvfs2tab, /etc/mtab, /etc/fstab)
• Force a sync on filesystem before beginning fsck

QUESTIONS:

• Does the underlying filesystem fsck interfere with pvfs2-validate?
• Should the underlying filesytem fsck be run in any conditions?
• How/When to clean up lost+found directory?
• What happens when lost+found directory has errors?
• Can anyone with root access run pvfs2-validate? Do we need some sort of authorization?
• Any known limits? (memory usage in pvfs2-validate, number of files)?
• Should we enter admin mode if there is no chance of repairs on found objects?
• Can pvfs2-validate be initiated automatically in some cases?
• When pvfs2-validate runs, how does is affect performance (readonly/repair)?
• Can the this be parallelized?
• Can we have a "conditional admin mode", where admin mode only entered after a certain time condition where no file system activity takes place? This would keep servers from entering admin mode in the middle of operations.

---

Function Documentation

int validate_pvfs_object (  const struct PINT_fsck_options *  fsck_options, const PVFS_object_ref *  pref, const PVFS_credentials *  creds, int *  cur_fs, char *  current_path )

Validate a PVFS2 file, directory or symlink. Operates recursively to descend into directories. Return values: 0  on success -PVFS_EWARNING  for non critical warnings -PVFS_error  on failure Parameters: fsck_options  fsck options pref  object to validate creds  caller's credentials cur_fs  file system current_path  path to object

Here is the call graph for this function:

---