1 Copyright 2000, International Business Machines Corporation.
4 This software has been released under the terms of the IBM Public
5 License. For details, see the LICENSE file in the top-level source
6 directory or online at http://www.openafs.org/dl/license10.html.
8 README file for libuafs and libjuafs, Version 1.2 06/04/2003.
13 This Makefile generates two libraries, the standard libuafs.a and
14 libuafs_pic.a, suitable for linking into shared libraries.
15 It installs libuafs.a as both itself and libjuafs.a, for use with
16 Java-enabled applications which expect that name, for historical
17 compatibility (see src/JAVA/libjafsadm/JAFSADM_README).
19 The libuafs.a library facilitates user authentication at a process
20 level and enables access and manipulation of the files and access
21 control lists (ACLs). By way of the libuafs.a klog function
22 (uafs_klog), the authenticated user's credentials are bound to the
23 executing process and therefore is granted permission to act on behalf
24 of the authenticated user.
29 As of 05/13/2002 the libuafs.a library remains unchanged with respect
30 to OpenAFS release 1.2.3.
34 A function like setpag but sets the current thread's pag id to a
35 caller-provided value instead of calling genpag(). This implements a
36 form of token caching since the caller can recall a particular pag value
37 for the thread to restore tokens, rather than reauthenticating.
42 A simple "make" will build libuafs.a and libuafs_pic.a.
47 The libuafs/UAFS directory is generated by the Makefile and contains the
48 object files and local copy of libuafs.a resulting from the build process.
49 The libuafs/UAFS.pic directory is the same as libuafs/UAFS, however it
50 contains output files respective to libuafs_pic.a.
53 ### CONSIDERATIONS ###
55 The libjuafs.a library has only been tested using RedHat Linux 7.3 and
56 OpenAFS 1.2.6, OpenAFS 1.2.7, OpenAFS 1.2.8, and OpenAFS 1.2.9.