Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add optional LD_PRELOAD library #737

Merged
merged 5 commits into from
Oct 10, 2022
Merged

Add optional LD_PRELOAD library #737

merged 5 commits into from
Oct 10, 2022

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.

3 participants