sfakeroot

manipulate files faking root privileges
git clone git://git.vx21.xyz/sfakeroot
Log | Files | Refs | README | LICENSE

README (1954B)


      1 sfakeroot
      2 =========
      3 
      4 sfakeroot is a minimalist fakeroot[1]. It uses the same LD_PRELOAD tricks
      5 as fakeroot to provide an environment in which stat() and related calls
      6 return uid/gid 0, so that files appear to be owned by root even when they're
      7 not. Inside the fakeroot environment permissions can be modified as if the
      8 current user is root, though ownership of the underlying files is never
      9 really changed. Any permissions set within the fakeroot environment will
     10 last only for the duration of the session, once sfakeroot exits all changes
     11 are lost.
     12 
     13 Why?
     14 ----
     15 
     16 sfakeroot was written because there is no OpenBSD compatible fakeroot
     17 equivalent, I considered porting fakeroot but it seemed too difficult.
     18 
     19 Installation
     20 ------------
     21 
     22 To build just run:
     23 
     24     $ make
     25 
     26 followed by (as root),
     27 
     28     # make install
     29 
     30 to install to standard locations.
     31 
     32 You can also uninstall with (as root),
     33 
     34     # make uninstall
     35 
     36 Contributing
     37 ------------
     38 
     39 Please feel welcome to submit patches and bug reports via email
     40 to my public-inbox ~richardipsum/public-inbox@lists.sr.ht
     41 alternatively patches may be submitted in private using the address
     42 found in the git log.
     43 
     44 See https://git-send-email.io/ for details on contributing
     45 via email with git.
     46 
     47 The archive of my public-inbox can be found at
     48 https://lists.sr.ht/~richardipsum/public-inbox.
     49 
     50 Known issues
     51 ------------
     52 
     53 Since OpenBSD's base utils are statically linked sfakeroot may be less
     54 useful on OpenBSD than it is on Linux, since the LD_PRELOAD tricks only
     55 work with dynamically linked executables. Even with dynamically linked
     56 executables sfakeroot may be of limited use for any programs using pledge(),
     57 since sfakeroot may try to make use of syscalls not specified in the pledge()
     58 call thereby causing sfakeroot to be terminated with SIGABRT.
     59 
     60 To make better use of sfakeroot on OpenBSD you may wish to use it with sbase[2].
     61 
     62 [1]: http://freshmeat.sourceforge.net/projects/fakeroot
     63 [2]: https://git.suckless.org/sbase/