Summary
=======

This case proposes to deliver packages containing the fakeroot software
tool.  Fakeroot[1] is a tool that provides an environment wherein an
ordinary user can run a command so that it appears to have root privileges
for file access.  This can be useful particularly in situations where
an ordinary user must manipulate files that would otherwise require
root privileges, for example, to create packages or archives containing
files owned by root.

The mechanism adopted by fakeroot(1) is to replace the file manipulation
library interfaces with its own versions that then simulate the effect
the native library functions would have had had they been run by the root
user.  The fakeroot-supplied functions exist in a library (libfakeroot.so)
which is loaded via LD_PRELOAD.

List of 'Faked' Functions
-------------------------
open, fopen, freopen, openat, lstat, stat, fstat, fstatat, lstat64, stat64,
fstat64, fstatat64, chown, lchown, fchown, fchownat, chmod, fchmod,
mknod, mkdir, unlink, unlinkat, rmdir, remove, rename, renameat,
getuid, getgid, geteuid, getegid, setuid, setgid, seteuid, setegid,
setreuid, setregid 

In addition, a daemon process, faked(1), runs; when a process running
under fakeroot attempts to change the ownership of a file, faked(1)
remembers the new 'fake' owner.  If the same fakeroot process subsquently
queries for the file owner, the 'fake' owner being tracked by faked(1)
is reported. The faked daemon automatically exits when the fakeroot
process exits.

fakeroot(1) does not alter the actual file permissions
or ownership in any way, shape or form, nor is there any escalation
of privileges of the user or process invoking fakeroot(1).  For greater
detail, please also refer to the fakeroot(1) man page in the accompanying
materials for greater detail.

fakeroot-1.11 will be integrated into the SFW consolidation as a
consequence of this proposal, and will be installed as SUNWfakeroot.

This proposal requests minor release binding.


Dependencies
============

None


Interfaces
==========

Exported Interfaces	Classification	Comment
===================	==============	===================
SUNWfakeroot		Uncommitted	Package
/usr/bin/fakeroot	Uncommitted	Command

Exported Interfaces	Classification	Comment
===================	==============	===========================
None

Other Files
===========

Project Private
===============
/usr/lib/faked			Daemon
/usr/lib/libfakeroot.so		Library
/usr/lib/64/libfakeroot.so	Library (64bit)

* 64 = {sparcv9 | amd64}

Reference Documentation
=======================
[1] http://fakeroot.alioth.debian.org/
[2] http://packages.qa.debian.org/f/fakeroot.html