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