From owner-freebsd-afs Mon Mar 9 08:11:54 1998 Return-Path: Received: (from majordom@localhost) by hub.freebsd.org (8.8.8/8.8.8) id IAA04978 for freebsd-afs-outgoing; Mon, 9 Mar 1998 08:11:54 -0800 (PST) (envelope-from owner-freebsd-afs@FreeBSD.ORG) Received: from sundance.stacken.kth.se (sundance.stacken.kth.se [130.237.234.41]) by hub.freebsd.org (8.8.8/8.8.8) with ESMTP id IAA04939 for ; Mon, 9 Mar 1998 08:11:40 -0800 (PST) (envelope-from art@stacken.kth.se) Received: from stacken.kth.se (art@squit.stacken.kth.se [130.237.234.56]) by sundance.stacken.kth.se (8.8.8/8.8.8) with ESMTP id RAA20724 for ; Mon, 9 Mar 1998 17:11:22 +0100 (MET) Message-Id: <199803091611.RAA20724@sundance.stacken.kth.se> To: afs@FreeBSD.ORG Subject: Forward: arla-0.1 From: Artur Grabowski X-Mailer: Mew version 1.70 on Emacs 19.34.2 X-URL: http://www.stacken.kth.se/~art/ Mime-Version: 1.0 Content-Type: Multipart/Mixed; boundary="--Next_Part(Mon_Mar__9_17:11:00_1998)--" Content-Transfer-Encoding: 7bit Date: Mon, 09 Mar 1998 17:11:08 +0100 Sender: owner-freebsd-afs@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org ----Next_Part(Mon_Mar__9_17:11:00_1998)-- Content-Type: Message/Rfc822 Content-Transfer-Encoding: 7bit Return-Path: assar@sics.se Delivery-Date: Mon Mar 2 02:08:06 1998 Received: from assaris.sics.se (assaris.sics.se [193.10.66.108]) by sundance.stacken.kth.se (8.8.8/8.8.8) with ESMTP id CAA06026 for ; Mon, 2 Mar 1998 02:08:01 +0100 (MET) Received: (from assar@localhost) by assaris.sics.se (8.8.5/8.7.3) id CAA07451; Mon, 2 Mar 1998 02:09:32 +0100 (MET) To: arla-announce@stacken.kth.se Subject: arla-0.1 Mime-Version: 1.0 (generated by tm-edit 7.68) Content-Type: multipart/mixed; boundary="Multipart_Mon_Mar__2_02:09:28_1998-1" Content-Transfer-Encoding: 7bit From: Assar Westerlund Date: 02 Mar 1998 02:09:29 +0100 Message-ID: <5lpvk57vau.fsf@assaris.sics.se> Lines: 216 X-Mailer: Gnus v5.5/Emacs 19.34 --Multipart_Mon_Mar__2_02:09:28_1998-1 Content-Type: text/plain; charset=US-ASCII The difference from 0.0 is mostly bug fixes. This code should be more stable and work better than 0.0. Send reports of your (un)successful building and installation of Arla to . Enjoy, /assar --Multipart_Mon_Mar__2_02:09:28_1998-1 Content-Type: text/plain; charset=ISO-8859-1 Content-Transfer-Encoding: quoted-printable README for arla-0.1 ($Name: arla-0-1 $) $Id: README,v 1.5.2.2 1998/03/02 00:33:58 assar Exp $ 1. What is arla? Arla is a free AFS cache-manager/client implementation. 2. Where do I find this file? This file is contained inside ftp://ftp.stacken.kth.se/pub/arla/arla-0.1.tar.gz (aka /afs/stacken.kth.se/ftp/pub/arla/arla-0.1.tar.gz). 3. What is AFS? AFS is a world-wide distributed file system. See for more information. 4. What's included in arla? There is kernel support (with different level of functionality) for the following operating systems: - FreeBSD 2.2 - OpenBSD 2.2 and 2.3 - NetBSD 1.2 and 1.3 - Linux 2.0.x (possibly 2.1.x?) - SunOS 4 - Solaris 2.5 A cache manager (arlad) that works both in user-level mode and with the kernel module. Some simple programs (fs and vos). Programs for acquiring tokens (kauth, afslog) are not included but are part of the kth-krb distribution. 5. What's the status or arla? This is a snapshot and pre-greek letters. Most of the functionality is there. You can read and write files and directories, with or without authentication. It's not as stable or high-performing as we would like, yet. The local authorization checks are not complete; if you fetch a file authenticated as one user, another user might be able to read that file. It only does whole-file caching, but that's probably good enough. 6. What do I need to run arla? If you have one of the systems listed above you will be able to mount afs as a file system (and probably to panic your kernel as well). The user-level programs should work and build on almost any other unix dialect. If you want to use authentication, you will also need a Kerberos v4 implementation. We use and recommend the one at . OpenBSD 2.3 already ships with kth-krb. However, you'll have to remove -DNO_AFS from /usr/src/kerberosIV/kafs/Makefile and rebuild kafs. If you don't have Kerberos, you should still be able to test that it works, but there's not much point in running unauthenticated, and it's not very tested. 7. How do I compile arla? Either: - run `./configure' in the source directory, or - run `SRCDIR/configure' in the directory where you want to build arla. (this is the recommended way but requires a make that understands VPATH) If you want to install somewhere different from the default `/usr/arla' give `--prefix=3DPATH' as an argument to configure. There are also some arla-specific arguments to configure: --with-arlacachedir=3Ddir use dir as cachedir instead of $prefix/cache --with-arlaconffile=3Dfile use file for configuration instead of $prefix/= etc/arla.conf --with-krb4=3Ddir use kerberos 4 in dir --with-krb4-lib=3Ddir use krb4-lib in dir --with-krb4-include=3Ddir use krb4-include in dir If there's no kernel support for your operating system, configure will print a warning to that effect and only the user-level stuff will be configured. then just run `make' 8. How do I install arla? Run `make install'. It will create and populate these directories: /usr/arla/bin=09=09all binaries used /usr/arla/cache=09=09the cached files will be stored here =09=09=09(core-dumps from arlad as well) /usr/arla/etc=09=09configuration files: =09=09=09ThisCell, CellServDB, arla.conf /usr/arla/lib=09=09random libraries If you're already part of an AFS cell, modify /usr/arla/etc/ThisCell and make sure your cell is mentioned in /usr/arla/etc/CellServDB. If you don't have a cell you'll still be able to run as a client in the cell `stacken.kth.se' and access all cells listed in CellServDB. 9. How do I start it? Start by running arlad in test mode with `-t'. If all goes well, it should print some messages and then give you the prompt `arla>'. There are very minimal commands for navigating the AFS space (ls, cd and cat). Type `help' to get a list of all the commands. If you have a kernel module you can try to load it and mount the file system. That's done somewhat differently depending on the operating system: Linux: mknod /dev/xfs c 60 0 insmod /usr/arla/bin/xfs.o /usr/arla/bin/arlad /dev/xfs mount -t xfs arla /afs SunOS4: modload /usr/arla/bin/libxfs.o modstat mknod /dev/xfs0 c 0 /usr/arla/bin/mount_xfs /afs /dev/xfs0 /usr/arla/bin/arlad /dev/xfs0 *BSD: modload -e xfs_mod -o /var/tmp/symbols /usr/arla/bin/xfs_mod.o mknod /dev/xfs0 c CDEV-MAJOR 0 # from console output from loading mkdir /afs /usr/arla/bin/mount_xfs /dev/xfs0 /afs /usr/arla/bin/arlad /dev/xfs0 10. What do I do when I find a bug? Report it with as much detail as possible (including patches) to . 11. How do I adjust the amount of debug information? Both arlad and the xfs (the kernel module) has variables for controlling what type of debug messages should be printed. They're called `xfsdeb' and `arladeb' and you either change them in the source code or patch the variables while running. The relevant files are xfs//xfs_deb.c and arlad/arladeb.c 12. How hard is it to port arla to a new operating system? It's not hard. The user-level code is quite portable and is not much different between different operating systems. The kernel module is system-specific but not that large and you can probably start with the one in `xfs/SYSTEM' that's most similar to your system. If you're interested in doing the port, send mail to . 13. How can I help? With code. Send us bug-reports and/or patches. 14. Are there any mailing lists for arla? arla-drinkers@stacken.kth.se=09general discussion arla-announce@stacken.kth.se=09only announcements Send mail to LIST-request@stacken.kth.se to subscribe. 15. Are there any copyrights on parts of arla? lwp and rx are copyrighted by IBM. We're grateful to Derrick J Brashear and Jim Doyle for making them available. the rxkad implementation was written by Bj=F6rn Gr=F6nvall and is also part of the kth-krb distribution. editline was written by Simmule Turner and Rich Salz. The code for gluing these together were written by ourselves. 16. What has changed since 0.0? Mostly bug-fixes. See ChangeLog for details. --Multipart_Mon_Mar__2_02:09:28_1998-1-- ----Next_Part(Mon_Mar__9_17:11:00_1998)---- To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-afs" in the body of the message