updates to wall.perl from michal@ellpspace.math.ualberta.ca
[kai/samba.git] / docs / README.OS2
1 Samba 1.9.15p8 for OS/2  :  REQUIRES emx 0.9b.
2
3
4 Please read the file README, which contains general information about
5 the configuration and use of Samba.
6
7
8 Notes specific to OS/2 port:
9 ============================
10
11 Filenames have been shortened to 8.3 in case anyone is using FAT.
12 Files affected are:
13 smb.conf  -> smb.cfg          smbclient -> smbclnt.exe
14 smbstatus -> smbstat.exe      nmblookup -> nmblook.exe
15
16 As I only use HPFS, I can't guarantee this will work on FAT systems,
17 although I have tried to stick to 8.3 filenames.  I have noticed some
18 temporary files being created with long filenames by smbd when I tried
19 printing (which does not work yet anyway).  nmbd will not be able to
20 create browse lists on FAT systems, as it uses temporary files with
21 long file names.
22
23 smb.cfg should be in the directory smbd is started from.  The path to
24 smb.cfg is a compile time option, so if you are compiling from source
25 you can set this to an absolute path to remove this restriction.
26
27 User home directories not supported.  This doesn't make much sense on
28 OS/2.  I haven't actually disabled anything, so if you try setting
29 this up, behaivour is undefined.
30
31 Password support is incomplete (I have found a crypt() routine, but 
32 lack of passwd file support in the EMX libraries make support difficult
33 without major changes).
34
35 Printing does not appear to be working.  OS/2's lpq gives output in a
36 different format than the versions of lpq already supported by samba.
37 This will be easy to accomodate, but there is not much point until I can
38 get lpr working properly.
39
40
41
42 Source is available from the Samba WWW site :
43
44 http://lake.canberra.edu.au/pub/samba/
45
46 EMX 0.9b is available from hobbes.nmsu.edu, ftp.cdrom.com, ftp.leo.org and
47 other OS/2 FTP sites.  emxrt.zip contains the required libraries.
48
49 Bugs:
50 =====
51
52 Known problems:
53 ===============
54
55 Printing does not work.  I have tried using REXX scripts with path info
56 built in, and watched the processes startup properly but nothing comes
57 out of the printer (remote via lpr in this case).
58 If you can get it going, please let me know how you did it.
59
60 The output from OS/2's lpq.exe is not understood by smbd, so all querys
61 about the print queue say it is empty.  Printing doesn't work anyway,
62 so I have not attempted to fix this yet.
63
64 Temporary files are created with long filenames (when printing, and updating
65 browse list)
66
67 Bug reports for the OS/2 port should be sent to Jason Rumney <jasonr@pec.co.nz>.
68
69 Change log:
70 ===========
71
72 Changes from release 1 to release 2.
73
74 nmblookup (nmblook.exe) is included, and works.
75
76 An attempt at password support was made using the gnuufc crypt routines,
77 but then I found that a lot of functions in the EMX libraries to do with
78 passwd files don't actually do anything.
79
80 Browse lists should now work if you use HPFS and set your lock directory
81 to an absolute pathname.