Skip to content

Conversation

@adammoody
Copy link
Collaborator

@adammoody adammoody commented Sep 14, 2022

Defines a new libunifyfs_preload_gotcha.so library to intercept file system calls from shell commands.

To build this library, add the --enable-preload configure option.

To use this library at runtime, the UnifyFS server should be started as normal. Then in the client, set LD_PRELOAD to point to the library install location. For example, a bash user can set:

export LD_PRELOAD=<unifyfs_install>/lib/libunifyfs_preload_gotcha.so

One may then run shell commands to interact with UnifyFS files, e.g.,:

touch /unifyfs/file1
cp -pr /unifyfs/file1 /unifyfs/file2
ls -l /unifyfs/file1
stat /unifyfs/file1
rm /unifyfs/file1

Due to the variety and variation of I/O functions that may be called by different commands, there is no guarantee that a given invocation is supported under UnifyFS semantics. This feature is experimental, and it should be used at your own risk.

Description

Motivation and Context

How Has This Been Tested?

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Performance enhancement (non-breaking change which improves efficiency)
  • Code cleanup (non-breaking change which makes code smaller or more readable)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Testing (addition of new tests or update to current tests)
  • Documentation (a change to man pages or other documentation)

Checklist:

  • My code follows the UnifyFS code style requirements.
  • I have updated the documentation accordingly.
  • I have read the CONTRIBUTING document.
  • I have added tests to cover my changes.
  • All new and existing tests passed.
  • All commit messages are properly formatted.

TEST_CHECKPATCH_SKIP_FILES="client/src/preload.c"
TEST_CHECKPATCH_SKIP_FILES="client/src/preload.c"
@adammoody
Copy link
Collaborator Author

Thanks @MichaelBrim and @CamStan .

@adammoody adammoody merged commit 4e67166 into dev Oct 10, 2022
@adammoody adammoody deleted the ld_preload branch October 10, 2022 22:49
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants