Imported Upstream version 2.5.1
[debian/amanda] / contrib / sst / README.Amanda
1 These are notes specific to using sst with Amanda on Solaris.
2
3 John R. Jackson
4 21-Nov-2000
5
6 ==============
7 Access as root
8 ==============
9
10 A change was made to the sst.c source code to allow access from non-root
11 users.  It #if's out a call to drv_priv() that checked against UID 0
12 (look for EPERM in the code).  Since Amanda does not normally run as
13 root, this was a problem.  Use the file system permissions on /dev/rsst*
14 to control access.
15
16 ========================
17 Using the GNU C compiler
18 ========================
19
20 If you build sst with the GNU C compiler for a 32 bit kernel (see below
21 for 64 bit kernel notes), you may get warnings like this:
22
23   warning: passing arg 1 of `timeout' from incompatible pointer type
24   .../include/va-sparc.h:29: warning: `va_start' redefined
25   .../include/va-sparc.h:29: warning: `va_end' redefined
26   .../include/va-sparc.h:29: warning: `va_arg' redefined
27   .../include/stdarg.h:163: warning: redefinition of `va_list'
28
29 These may all be ignored.
30
31 A change was made to the sst.c source code to get around the following
32 error:
33
34   `__builtin_va_alist' undeclared
35
36 It adds a #include of stdarg.h if __GNUC__ is #define'd.
37
38 ============================
39 Building for a 64 bit kernel
40 ============================
41
42 The sst driver build instructions are for a 32 bit kernel.  If you want
43 to build for a 64 bit kernel, compile it like this:
44
45   cc -D_KERNEL -D_SYSCALL32 -xarch=v9 -c sst.c
46
47 Drivers for 64 bit kernels go in /usr/kernel/drv/sparcv9 instead of
48 /usr/kernel/drv.  However their .conf files still go in /usr/kernel/drv,
49 regardless of bit size.
50
51 At the time this is being written, only the Sun C compiler is able to
52 (reliably) build kernel drivers for 64 bit architectures.  GNU C is not
53 yet up to the task.
54
55 ==================
56 Using sgen instead
57 ==================
58
59 Solaris 8 comes with a new driver, sgen, that provides raw SCSI access
60 ala sst, but with (presumably) better long term support (since sst is
61 intended only as a development starting point).  At the time this is
62 being written, the chg-scsi changer reportedly works with sgen, but be
63 sure and read the sgen(7D) man page for instructions on setting it up.
64 In particular, you must edit sgen.conf to get the device entries created.
65 Also, the default permissions only allow root access, so you'll need to
66 open them up just enough to allow Amanda to issue commands.