From 0e8fd3398771da2f016d72830179507f3edda51b Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Sat, 4 May 1996 07:50:46 +0000 Subject: Initial version imported to CVS (This used to be commit 291551d80711daab7b7581720bcd9a08d6096517) --- README | 111 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 111 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000000..b7ef5d5595 --- /dev/null +++ b/README @@ -0,0 +1,111 @@ +This is version 1.9 of Samba, the free SMB client and server for unix. + +>>>> Please read THE WHOLE of this file as it gives important information +>>>> about the configuration and use of Samba. + +This software is freely distributable under the GNU public license, a +copy of which you should have received with this software (in a file +called COPYING). + +WHAT CAN SAMBA DO? +================== + +Here is a very short list of what samba includes, and what it does + +- a SMB server, to provide LanManager style file and print services to PCs + +- a Netbios (rfc1001/1002) nameserver + +- a ftp-like SMB client so you can access PC resources (disks and +printers) from unix + +- a tar extension to the client for backing up PCs + +Related packages include: + +- ksmbfs, a linux-only filesystem allowing you to mount remote SMB +filesystems from PCs on your linux box + +- tcpdump-smb, a extension to tcpdump to allow you to investigate SMB +networking problems over netbeui and tcp/ip + + +CONTRIBUTIONS +============= + +If you want to contribute to the development of the software then +please join the mailing list. I accept patches (preferably in +"diff -u" format) and am always glad to receive feedback or suggestions. + +You could also send hardware/software/money/jewelry or pizza +vouchers directly to me. The pizza vouchers would be especially +welcome :-) + +If you like a particular feature then look through the change-log and +see who added it, then send them an email. + +Remember that free software of this kind lives or dies by the response +we get. If noone tells us they like it then we'll probably move onto +something else. + +Andrew Tridgell +Email: samba-bugs@anu.edu.au + +3 Ballow Crescent +Macgregor, A.C.T. +2615 Australia + + +MORE INFO +========= + +DOCUMENTATION +------------- + +There is quite a bit of documentation included with the package, +including man pages, and lots of .txt files with hints and useful +info. + +FTP SITE +-------- + +The main anonymous ftp distribution site for this software is +nimbus.anu.edu.au in the directory pub/tridge/samba/. + +MAILING LIST +------------ + +There is a mailing list for discussion of Samba. To subscribe send +mail to listproc@anu.edu.au with a body of "subscribe samba Your Name" + +To send mail to everyone on the list mail to samba@listproc.anu.edu.au + +There is also an announcement mailing list where I announce new +versions. To subscribe send mail to listproc@anu.edu.au with a body +of "subscribe samba-announce Your Name". All announcements also go to +the samba list. + + +NEWS GROUP +---------- + +You might also like to look at the usenet news group +comp.protocols.smb as it often contains lots of useful info and is +frequented by lots of Samba users. The newsgroup was initially setup +by people on the Samba mailing list. It is not, however, exclusive to +Samba, it is a forum for discussing the SMB protocol (which Samba +implements). + + +WEB SITE +-------- + +A Samba WWW site has been setup with lots of useful info. Connect to: + +http://lake.canberra.edu.au/pub/samba/ + +It is maintained by Paul Blackman (thanks Paul!). You can contact him +at ictinus@lake.canberra.edu.au. + + + -- cgit From 3a5b9fc23fcbd9fdfd3eb726597b8c5a7ee53382 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Sat, 4 May 1996 07:55:56 +0000 Subject: updated README for new samba.anu.edu.u alias (This used to be commit 2b126502f46893ca2cd356ae896d611fc19d2c0a) --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index b7ef5d5595..1352ccfcc9 100644 --- a/README +++ b/README @@ -49,7 +49,7 @@ we get. If noone tells us they like it then we'll probably move onto something else. Andrew Tridgell -Email: samba-bugs@anu.edu.au +Email: samba-bugs@samba.anu.edu.au 3 Ballow Crescent Macgregor, A.C.T. @@ -76,12 +76,12 @@ MAILING LIST ------------ There is a mailing list for discussion of Samba. To subscribe send -mail to listproc@anu.edu.au with a body of "subscribe samba Your Name" +mail to listproc@samba.anu.edu.au with a body of "subscribe samba Your Name" To send mail to everyone on the list mail to samba@listproc.anu.edu.au There is also an announcement mailing list where I announce new -versions. To subscribe send mail to listproc@anu.edu.au with a body +versions. To subscribe send mail to listproc@samba.anu.edu.au with a body of "subscribe samba-announce Your Name". All announcements also go to the samba list. -- cgit From b2740f43b1c69f3ae3889e6ed88cb593316b098a Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Sat, 4 May 1996 13:14:08 +0000 Subject: Changed to reflect new ownership by Microsoft (This used to be commit 37736c8c5e8223c3f39e9508cd508cb33a34f6b3) --- README | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README') diff --git a/README b/README index 1352ccfcc9..e9cfbd8266 100644 --- a/README +++ b/README @@ -1,3 +1,5 @@ +This product is wholly owned by Microsoft. + This is version 1.9 of Samba, the free SMB client and server for unix. >>>> Please read THE WHOLE of this file as it gives important information -- cgit From fcfe0021384f0a55c2683ce517d39b306525aba0 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Sat, 4 May 1996 13:17:14 +0000 Subject: removed obscene comment added by Dan (This used to be commit a7005f50d800174862a6b58727c7387e6d3581be) --- README | 2 -- 1 file changed, 2 deletions(-) (limited to 'README') diff --git a/README b/README index e9cfbd8266..1352ccfcc9 100644 --- a/README +++ b/README @@ -1,5 +1,3 @@ -This product is wholly owned by Microsoft. - This is version 1.9 of Samba, the free SMB client and server for unix. >>>> Please read THE WHOLE of this file as it gives important information -- cgit From 4c67f3701f04bf8d1bee7ad397f7621c2e86299e Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Fri, 17 May 1996 00:43:54 +0000 Subject: Made chang blody comso: can't see what i'm writing... Made changes to reflect nimbus.anu.edu.au -> samba.anu.edu.au chage. changed reference to /ub/samba/change-log o /ub/samba/alpha/change-log Also added samba.faq.html to docs directory Paul... (This used to be commit d6f124a7ca1806230c374f871ba7fe17284b6042) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 1352ccfcc9..1980a98236 100644 --- a/README +++ b/README @@ -102,7 +102,7 @@ WEB SITE A Samba WWW site has been setup with lots of useful info. Connect to: -http://lake.canberra.edu.au/pub/samba/ +http://samba.canberra.edu.au/pub/samba/ It is maintained by Paul Blackman (thanks Paul!). You can contact him at ictinus@lake.canberra.edu.au. -- cgit From b479eafd667f0720ca27afe04df5c4a79fb1fa78 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Mon, 20 May 1996 08:11:51 +0000 Subject: Changed more references of 'nimbus.anu.edu.au/pub/tridge/samba' to 'samba.anu.edu.au/pub/samba' The only reference I see now to 'nimbus' is in ENCRYPTION.txt regarding libdes stuff. Paul... (This used to be commit eee3a6f139c2a773979e4cd771e4567178805846) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 1980a98236..fff7d4d248 100644 --- a/README +++ b/README @@ -70,7 +70,7 @@ FTP SITE -------- The main anonymous ftp distribution site for this software is -nimbus.anu.edu.au in the directory pub/tridge/samba/. +samba.anu.edu.au in the directory pub/samba/. MAILING LIST ------------ -- cgit From 3e8ddf7aec72015c2d4414c940d15c74e9cbf30b Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Thu, 23 May 1996 23:55:13 +0000 Subject: General updating. Dan (This used to be commit 2209de41df38f1bc6ac5b442b3b696b680fcf639) --- README | 7 ++++++- 1 file changed, 6 insertions(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index fff7d4d248..84bc00b2ef 100644 --- a/README +++ b/README @@ -35,7 +35,8 @@ CONTRIBUTIONS If you want to contribute to the development of the software then please join the mailing list. I accept patches (preferably in -"diff -u" format) and am always glad to receive feedback or suggestions. +"diff -u" format, see docs/BUGS.txt for more details) and am always glad to +receive feedback or suggestions. You could also send hardware/software/money/jewelry or pizza vouchers directly to me. The pizza vouchers would be especially @@ -104,6 +105,10 @@ A Samba WWW site has been setup with lots of useful info. Connect to: http://samba.canberra.edu.au/pub/samba/ +As well as general information and documentation, this also has searchable +archives of the mailing list and a user survey that shows who else is using +this package. Have you registered with the survey yet? :-) + It is maintained by Paul Blackman (thanks Paul!). You can contact him at ictinus@lake.canberra.edu.au. -- cgit From 851ee418b499df481b765286405cd761e91dcaaf Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Wed, 19 Jun 1996 13:23:46 +0000 Subject: Basic doc changes to keep up to date. Dan (This used to be commit 6d81d56f929e763bcf6b1f7a61aabaf884c4aad4) --- README | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) (limited to 'README') diff --git a/README b/README index 84bc00b2ef..07896e7a1d 100644 --- a/README +++ b/README @@ -10,21 +10,27 @@ called COPYING). WHAT CAN SAMBA DO? ================== -Here is a very short list of what samba includes, and what it does +Here is a very short list of what samba includes, and what it does. -- a SMB server, to provide LanManager style file and print services to PCs +- a SMB server, to provide Windows NT and LAN Manager-style file and print + services to SMB clients such as Windows 95, Warp Server, smbfs and others. -- a Netbios (rfc1001/1002) nameserver +- a Netbios (rfc1001/1002) nameserver, which among other things gives + browsing support. Samba can be the master browser on your LAN if you wish. - a ftp-like SMB client so you can access PC resources (disks and -printers) from unix +printers) from unix, Netware and other operating systems - a tar extension to the client for backing up PCs +For a much better overview have a look at the web site at +http://samba.canberra.edu.au/pub/samba, and browse the user survey. + Related packages include: -- ksmbfs, a linux-only filesystem allowing you to mount remote SMB -filesystems from PCs on your linux box +- smbfs, a linux-only filesystem allowing you to mount remote SMB +filesystems from PCs on your linux box. This is included as standard with +Linux 2.0 and later. - tcpdump-smb, a extension to tcpdump to allow you to investigate SMB networking problems over netbeui and tcp/ip @@ -47,7 +53,8 @@ see who added it, then send them an email. Remember that free software of this kind lives or dies by the response we get. If noone tells us they like it then we'll probably move onto -something else. +something else. However, as you can see from the user survey quite a lot of +people do seem to like it at the moment :-) Andrew Tridgell Email: samba-bugs@samba.anu.edu.au -- cgit From a7ed8cd8ac3e1c0f8cd68bed654ae21cb3acde12 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Sat, 27 Jul 1996 14:18:55 +0000 Subject: Lots of updating. Dan (This used to be commit 66148db2f7e421b84986abddd21354dcf821d9d6) --- README | 56 +++++++++++++++++++++++++++++++++++++++++++------------- 1 file changed, 43 insertions(+), 13 deletions(-) (limited to 'README') diff --git a/README b/README index 07896e7a1d..1426c67bf1 100644 --- a/README +++ b/README @@ -1,4 +1,6 @@ -This is version 1.9 of Samba, the free SMB client and server for unix. +This is version 1.9 of Samba, the free SMB client and server for unix +and other operating systems. Samba is maintained by the Samba Team, +who support the original author and principal maintainer, Andrew Tridgell. >>>> Please read THE WHOLE of this file as it gives important information >>>> about the configuration and use of Samba. @@ -7,6 +9,27 @@ This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file called COPYING). +WHAT IS SMB? +============ + +This is a big question. + +The very short answer is that it is the protocol by which a lot of +PC-related machines share files and printers and other informatiuon +such as lists of available files and printers. Operating systems that +support this natively include Windows NT, OS/2, and Linux and add on +packages that achieve the same thing are available for DOS, Windows, +VMS, Unix of all kinds, MVS, and more. There is no reason why Apple +Macs and indeed any Web browser should not be able to speak this +protocol, and current development (in which the Samba team is heavily +involved) is aimed at exactly that. Alternatives to SMB include +Netware, NFS, Appletalk, Banyan Vines, Decnet etc; many of these have +advantages but none are both public specifications and widely +implemented in desktop machines by default. + +The Common Internet Filesystem is what the new SMB initiative is +called. For details watch http://samba.anu.edu.au/cifs. + WHAT CAN SAMBA DO? ================== @@ -33,20 +56,25 @@ filesystems from PCs on your linux box. This is included as standard with Linux 2.0 and later. - tcpdump-smb, a extension to tcpdump to allow you to investigate SMB -networking problems over netbeui and tcp/ip +networking problems over netbeui and tcp/ip. +- smblib, a library of smb functions which are designed to make it +easy to smb-ise any particular application. See +ftp://samba.anu.edu.au/pub/samba/smblib. CONTRIBUTIONS ============= If you want to contribute to the development of the software then -please join the mailing list. I accept patches (preferably in -"diff -u" format, see docs/BUGS.txt for more details) and am always glad to -receive feedback or suggestions. +please join the mailing list. The Samba team accepts patches +(preferably in "diff -u" format, see docs/BUGS.txt for more details) +and are always glad to receive feedback or suggestions to the address +samba-bugs@samba.anu.edu.au. You could also send hardware/software/money/jewelry or pizza -vouchers directly to me. The pizza vouchers would be especially -welcome :-) +vouchers directly to Andrew. The pizza vouchers would be especially +welcome, in fact there is a special field in the survey for people who +have paid up their pizza :-) If you like a particular feature then look through the change-log and see who added it, then send them an email. @@ -63,6 +91,8 @@ Email: samba-bugs@samba.anu.edu.au Macgregor, A.C.T. 2615 Australia +Samba Team +Email: samba-team@samba.anu.edu.au MORE INFO ========= @@ -72,7 +102,7 @@ DOCUMENTATION There is quite a bit of documentation included with the package, including man pages, and lots of .txt files with hints and useful -info. +info. This is also available from the web page. FTP SITE -------- @@ -88,10 +118,10 @@ mail to listproc@samba.anu.edu.au with a body of "subscribe samba Your Name" To send mail to everyone on the list mail to samba@listproc.anu.edu.au -There is also an announcement mailing list where I announce new -versions. To subscribe send mail to listproc@samba.anu.edu.au with a body -of "subscribe samba-announce Your Name". All announcements also go to -the samba list. +There is also an announcement mailing list where new versions are +announced. To subscribe send mail to listproc@samba.anu.edu.au with a +body of "subscribe samba-announce Your Name". All announcements also +go to the samba list. NEWS GROUP @@ -102,7 +132,7 @@ comp.protocols.smb as it often contains lots of useful info and is frequented by lots of Samba users. The newsgroup was initially setup by people on the Samba mailing list. It is not, however, exclusive to Samba, it is a forum for discussing the SMB protocol (which Samba -implements). +implements). The samba list is gatewayed to this newsgroup. WEB SITE -- cgit From 86c72d5e88fffe18f85ee97e8c2bd14ec277d0f1 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Thu, 22 Aug 1996 16:08:25 +0000 Subject: minor doc fix (This used to be commit 0e37688745f00787fab0c10e257d0526395456a2) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 1426c67bf1..231bf7b847 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is version 1.9 of Samba, the free SMB client and server for unix +This is version 1.9.16 of Samba, the free SMB client and server for unix and other operating systems. Samba is maintained by the Samba Team, who support the original author and principal maintainer, Andrew Tridgell. -- cgit From 49f6320cf668c7baafdf63c0a1aa6f8576382702 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Thu, 22 May 1997 18:34:46 +0000 Subject: README: Updated for 1.9.17. Andrew no longer listed as primary maintainer. WHATSNEW.txt: New file - the idea is that it is updated for new releases and acts as a first point for users who want to see if they should upgrade. jallison@whistle.com (This used to be commit 9773d1df2db6131990bbcc678b1bb63bfcb2d02b) --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'README') diff --git a/README b/README index 231bf7b847..9bc9953c26 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ -This is version 1.9.16 of Samba, the free SMB client and server for unix +This is version 1.9.17 of Samba, the free SMB client and server for unix and other operating systems. Samba is maintained by the Samba Team, -who support the original author and principal maintainer, Andrew Tridgell. +who support the original author, Andrew Tridgell. >>>> Please read THE WHOLE of this file as it gives important information >>>> about the configuration and use of Samba. -- cgit From 28429a130bc5fc8d9d21193072f0077d3f6a34d0 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Tue, 26 Aug 1997 01:08:49 +0000 Subject: Removed samba team email address - replaced with samba bugs. Jeremy (jallison@whistle.com) (This used to be commit 320a739161dee082c53b59106df90e760bc41c0e) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 9bc9953c26..15dd87e87e 100644 --- a/README +++ b/README @@ -92,7 +92,7 @@ Macgregor, A.C.T. 2615 Australia Samba Team -Email: samba-team@samba.anu.edu.au +Email: samba-bugs@samba.anu.edu.au MORE INFO ========= -- cgit From e8aa1ba0622851a5e05542b8c6a038001e4ff3d3 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Tue, 26 Aug 1997 14:46:52 +0000 Subject: Changed ftp site and docs info in README (this file contains out-of-date FAQ info and should be scrapped.) Changed "qaility control" in the Roadmap :-) (This used to be commit 28833abf18c5612f274e2199f2072631df771e40) --- README | 17 ++++++++--------- 1 file changed, 8 insertions(+), 9 deletions(-) (limited to 'README') diff --git a/README b/README index 15dd87e87e..ba982448e1 100644 --- a/README +++ b/README @@ -19,10 +19,8 @@ PC-related machines share files and printers and other informatiuon such as lists of available files and printers. Operating systems that support this natively include Windows NT, OS/2, and Linux and add on packages that achieve the same thing are available for DOS, Windows, -VMS, Unix of all kinds, MVS, and more. There is no reason why Apple -Macs and indeed any Web browser should not be able to speak this -protocol, and current development (in which the Samba team is heavily -involved) is aimed at exactly that. Alternatives to SMB include +VMS, Unix of all kinds, MVS, and more. Apple Macs and some Web Browsers +can speak this protocol as well. Alternatives to SMB include Netware, NFS, Appletalk, Banyan Vines, Decnet etc; many of these have advantages but none are both public specifications and widely implemented in desktop machines by default. @@ -102,19 +100,22 @@ DOCUMENTATION There is quite a bit of documentation included with the package, including man pages, and lots of .txt files with hints and useful -info. This is also available from the web page. +info. This is also available from the web page. There is a growing +collection of information under docs/faq; by the next release expect +this to be the default starting point. FTP SITE -------- -The main anonymous ftp distribution site for this software is -samba.anu.edu.au in the directory pub/samba/. +Please use a mirror site! The list of mirrors is in docs/MIRRORS.txt. +The master ftp site is samba.anu.edu.au in the directory pub/samba. MAILING LIST ------------ There is a mailing list for discussion of Samba. To subscribe send mail to listproc@samba.anu.edu.au with a body of "subscribe samba Your Name" +Please do NOT send this request to the list alias instead. To send mail to everyone on the list mail to samba@listproc.anu.edu.au @@ -149,5 +150,3 @@ this package. Have you registered with the survey yet? :-) It is maintained by Paul Blackman (thanks Paul!). You can contact him at ictinus@lake.canberra.edu.au. - - -- cgit From 754c280835d516f3d6d78872f6eaecc70c10af43 Mon Sep 17 00:00:00 2001 From: Samba Release Account Date: Tue, 7 Oct 1997 04:56:02 +0000 Subject: More references to samba.canberra Mental note: always commit from root directory. :^o Paul. (This used to be commit 5a38eaac75a6bede2d946f69cf664d7ca3989b55) --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index ba982448e1..3010324184 100644 --- a/README +++ b/README @@ -45,7 +45,7 @@ printers) from unix, Netware and other operating systems - a tar extension to the client for backing up PCs For a much better overview have a look at the web site at -http://samba.canberra.edu.au/pub/samba, and browse the user survey. +http://samba.anu.edu.au/samba, and browse the user survey. Related packages include: @@ -141,12 +141,12 @@ WEB SITE A Samba WWW site has been setup with lots of useful info. Connect to: -http://samba.canberra.edu.au/pub/samba/ +http://samba.anu.edu.au/samba/ As well as general information and documentation, this also has searchable archives of the mailing list and a user survey that shows who else is using this package. Have you registered with the survey yet? :-) It is maintained by Paul Blackman (thanks Paul!). You can contact him -at ictinus@lake.canberra.edu.au. +at ictinus@samba.anu.edu.au. -- cgit From 7a98737d40240d2f9110a1cae96df20c50af98be Mon Sep 17 00:00:00 2001 From: Dan Shearer Date: Sun, 21 Dec 1997 00:00:25 +0000 Subject: Updates for 1.9.18 (This used to be commit 338407732d1473ab3682c6090db297e76d864b94) --- README | 41 ++++++++++++++++++++++++++++++++++------- 1 file changed, 34 insertions(+), 7 deletions(-) (limited to 'README') diff --git a/README b/README index 3010324184..781595dd15 100644 --- a/README +++ b/README @@ -1,6 +1,6 @@ -This is version 1.9.17 of Samba, the free SMB client and server for unix -and other operating systems. Samba is maintained by the Samba Team, -who support the original author, Andrew Tridgell. +This is version 1.9.18 of Samba, the free SMB and CIFS client and +server for unix and other operating systems. Samba is maintained by +the Samba Team, who support the original author, Andrew Tridgell. >>>> Please read THE WHOLE of this file as it gives important information >>>> about the configuration and use of Samba. @@ -28,10 +28,26 @@ implemented in desktop machines by default. The Common Internet Filesystem is what the new SMB initiative is called. For details watch http://samba.anu.edu.au/cifs. +WHY DO PEOPLE WANT TO USE SMB? +============================== + +1. Many people want to integrate their Microsoft or IBM style desktop + machines with their Unix or VMS (etc) servers. + +2. Others want to integrate their Microsoft (etc) servers with Unix + or VMS (etc) servers. This is a different problem to integrating + desktop clients. + +3. Others want to replace protocols like NFS, DecNet and Novell NCP, + especially when used with PCs. + + WHAT CAN SAMBA DO? ================== -Here is a very short list of what samba includes, and what it does. +Here is a very short list of what samba includes, and what it does. For +many networks this can be simply summarised by "Samba provides a complete +replacement for Windows NT, Warp, NFS or Netware servers." - a SMB server, to provide Windows NT and LAN Manager-style file and print services to SMB clients such as Windows 95, Warp Server, smbfs and others. @@ -67,15 +83,19 @@ If you want to contribute to the development of the software then please join the mailing list. The Samba team accepts patches (preferably in "diff -u" format, see docs/BUGS.txt for more details) and are always glad to receive feedback or suggestions to the address -samba-bugs@samba.anu.edu.au. +samba-bugs@samba.anu.edu.au. We have recently put a new bug tracking +system into place which should help the throughput quite a lot. You +can also get the Samba sourcecode straight from the CVS tree - see +http://samba.anu.edu.au/cvs.html. You could also send hardware/software/money/jewelry or pizza vouchers directly to Andrew. The pizza vouchers would be especially welcome, in fact there is a special field in the survey for people who have paid up their pizza :-) -If you like a particular feature then look through the change-log and -see who added it, then send them an email. +If you like a particular feature then look through the CVS change-log +(on the web at http://samba.anu.edu.au/cgi-bin/cvsweb/samba) and see +who added it, then send them an email. Remember that free software of this kind lives or dies by the response we get. If noone tells us they like it then we'll probably move onto @@ -104,6 +124,13 @@ info. This is also available from the web page. There is a growing collection of information under docs/faq; by the next release expect this to be the default starting point. +A list of Samba documentation in languages other than English is +available on the web page. + +If you would like to help with the documentation (and we _need_ help!) +then have a look at the mailing list samba-docs, archived at +http://samba.anu.edu.au/listproc/samba-docs. + FTP SITE -------- -- cgit From c98d175de5c605c70ad9288a29df05f83fda0536 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Mon, 31 Aug 1998 05:21:09 +0000 Subject: updated the WHATSNEW in preparation for an alpha release (This used to be commit 2f09b68e52a3af712d86732ed674e1e616768d65) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 781595dd15..14c2eac661 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is version 1.9.18 of Samba, the free SMB and CIFS client and +This is version 2.0.0alphaX of Samba, the free SMB and CIFS client and server for unix and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. -- cgit From 83698a817135d4f9c137ae959d96e22f04cb78fb Mon Sep 17 00:00:00 2001 From: Luke Leighton Date: Thu, 12 Nov 1998 16:41:19 +0000 Subject: minor update. (This used to be commit d0d0196af55cad00cbdebd8c80941f42e667e199) --- README | 20 ++++++++++++++++---- 1 file changed, 16 insertions(+), 4 deletions(-) (limited to 'README') diff --git a/README b/README index 14c2eac661..c4ea941416 100644 --- a/README +++ b/README @@ -9,6 +9,7 @@ This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file called COPYING). + WHAT IS SMB? ============ @@ -25,8 +26,9 @@ Netware, NFS, Appletalk, Banyan Vines, Decnet etc; many of these have advantages but none are both public specifications and widely implemented in desktop machines by default. -The Common Internet Filesystem is what the new SMB initiative is -called. For details watch http://samba.anu.edu.au/cifs. +The Common Internet Filesystem (CIFS) is what the new SMB initiative +is called. For details watch http://samba.anu.edu.au/cifs. + WHY DO PEOPLE WANT TO USE SMB? ============================== @@ -52,7 +54,7 @@ replacement for Windows NT, Warp, NFS or Netware servers." - a SMB server, to provide Windows NT and LAN Manager-style file and print services to SMB clients such as Windows 95, Warp Server, smbfs and others. -- a Netbios (rfc1001/1002) nameserver, which among other things gives +- a NetBIOS (rfc1001/1002) nameserver, which amongst other things gives browsing support. Samba can be the master browser on your LAN if you wish. - a ftp-like SMB client so you can access PC resources (disks and @@ -60,6 +62,9 @@ printers) from unix, Netware and other operating systems - a tar extension to the client for backing up PCs +- limited command-line tool that supports some of the NT administrative + functionality, which can be used on Samba, NT workstation and NT server. + For a much better overview have a look at the web site at http://samba.anu.edu.au/samba, and browse the user survey. @@ -76,6 +81,7 @@ networking problems over netbeui and tcp/ip. easy to smb-ise any particular application. See ftp://samba.anu.edu.au/pub/samba/smblib. + CONTRIBUTIONS ============= @@ -112,6 +118,7 @@ Macgregor, A.C.T. Samba Team Email: samba-bugs@samba.anu.edu.au + MORE INFO ========= @@ -131,12 +138,14 @@ If you would like to help with the documentation (and we _need_ help!) then have a look at the mailing list samba-docs, archived at http://samba.anu.edu.au/listproc/samba-docs. + FTP SITE -------- Please use a mirror site! The list of mirrors is in docs/MIRRORS.txt. The master ftp site is samba.anu.edu.au in the directory pub/samba. + MAILING LIST ------------ @@ -151,6 +160,9 @@ announced. To subscribe send mail to listproc@samba.anu.edu.au with a body of "subscribe samba-announce Your Name". All announcements also go to the samba list. +For details of other Samba mailing lists and for access to archives, see +http://samba.anu.edu.au/listproc. + NEWS GROUP ---------- @@ -175,5 +187,5 @@ archives of the mailing list and a user survey that shows who else is using this package. Have you registered with the survey yet? :-) It is maintained by Paul Blackman (thanks Paul!). You can contact him -at ictinus@samba.anu.edu.au. +as ictinus@samba.anu.edu.au. -- cgit From f120a81a727efbb6c264b90df3c7b78ab554a428 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Sat, 21 Nov 1998 13:20:31 +0000 Subject: global change from samba.anu.edu.au to samba.org (This used to be commit 42d2509c9fab5c774fd33b9d4b5bd1ee125479c3) --- README | 30 +++++++++++++++--------------- 1 file changed, 15 insertions(+), 15 deletions(-) (limited to 'README') diff --git a/README b/README index c4ea941416..8772e79d8c 100644 --- a/README +++ b/README @@ -27,7 +27,7 @@ advantages but none are both public specifications and widely implemented in desktop machines by default. The Common Internet Filesystem (CIFS) is what the new SMB initiative -is called. For details watch http://samba.anu.edu.au/cifs. +is called. For details watch http://samba.org/cifs. WHY DO PEOPLE WANT TO USE SMB? @@ -66,7 +66,7 @@ printers) from unix, Netware and other operating systems functionality, which can be used on Samba, NT workstation and NT server. For a much better overview have a look at the web site at -http://samba.anu.edu.au/samba, and browse the user survey. +http://samba.org/samba, and browse the user survey. Related packages include: @@ -79,7 +79,7 @@ networking problems over netbeui and tcp/ip. - smblib, a library of smb functions which are designed to make it easy to smb-ise any particular application. See -ftp://samba.anu.edu.au/pub/samba/smblib. +ftp://samba.org/pub/samba/smblib. CONTRIBUTIONS @@ -89,10 +89,10 @@ If you want to contribute to the development of the software then please join the mailing list. The Samba team accepts patches (preferably in "diff -u" format, see docs/BUGS.txt for more details) and are always glad to receive feedback or suggestions to the address -samba-bugs@samba.anu.edu.au. We have recently put a new bug tracking +samba-bugs@samba.org. We have recently put a new bug tracking system into place which should help the throughput quite a lot. You can also get the Samba sourcecode straight from the CVS tree - see -http://samba.anu.edu.au/cvs.html. +http://samba.org/cvs.html. You could also send hardware/software/money/jewelry or pizza vouchers directly to Andrew. The pizza vouchers would be especially @@ -100,7 +100,7 @@ welcome, in fact there is a special field in the survey for people who have paid up their pizza :-) If you like a particular feature then look through the CVS change-log -(on the web at http://samba.anu.edu.au/cgi-bin/cvsweb/samba) and see +(on the web at http://samba.org/cgi-bin/cvsweb/samba) and see who added it, then send them an email. Remember that free software of this kind lives or dies by the response @@ -109,14 +109,14 @@ something else. However, as you can see from the user survey quite a lot of people do seem to like it at the moment :-) Andrew Tridgell -Email: samba-bugs@samba.anu.edu.au +Email: samba-bugs@samba.org 3 Ballow Crescent Macgregor, A.C.T. 2615 Australia Samba Team -Email: samba-bugs@samba.anu.edu.au +Email: samba-bugs@samba.org MORE INFO @@ -136,32 +136,32 @@ available on the web page. If you would like to help with the documentation (and we _need_ help!) then have a look at the mailing list samba-docs, archived at -http://samba.anu.edu.au/listproc/samba-docs. +http://samba.org/listproc/samba-docs. FTP SITE -------- Please use a mirror site! The list of mirrors is in docs/MIRRORS.txt. -The master ftp site is samba.anu.edu.au in the directory pub/samba. +The master ftp site is samba.org in the directory pub/samba. MAILING LIST ------------ There is a mailing list for discussion of Samba. To subscribe send -mail to listproc@samba.anu.edu.au with a body of "subscribe samba Your Name" +mail to listproc@samba.org with a body of "subscribe samba Your Name" Please do NOT send this request to the list alias instead. To send mail to everyone on the list mail to samba@listproc.anu.edu.au There is also an announcement mailing list where new versions are -announced. To subscribe send mail to listproc@samba.anu.edu.au with a +announced. To subscribe send mail to listproc@samba.org with a body of "subscribe samba-announce Your Name". All announcements also go to the samba list. For details of other Samba mailing lists and for access to archives, see -http://samba.anu.edu.au/listproc. +http://samba.org/listproc. NEWS GROUP @@ -180,12 +180,12 @@ WEB SITE A Samba WWW site has been setup with lots of useful info. Connect to: -http://samba.anu.edu.au/samba/ +http://samba.org/samba/ As well as general information and documentation, this also has searchable archives of the mailing list and a user survey that shows who else is using this package. Have you registered with the survey yet? :-) It is maintained by Paul Blackman (thanks Paul!). You can contact him -as ictinus@samba.anu.edu.au. +as ictinus@samba.org. -- cgit From b097ddb724b54812ea5e116bf2069bc912f225a4 Mon Sep 17 00:00:00 2001 From: Tim Potter Date: Mon, 7 Jun 1999 23:28:39 +0000 Subject: Bumped version number in README to avoid confusion with SAMBA_2_0 branch. (This used to be commit 341cf8aa8ee9ba10e8777d21dbbb31769f710692) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index 8772e79d8c..d1e50585c8 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is version 2.0.0alphaX of Samba, the free SMB and CIFS client and +This is version 2.1.0alphaX of Samba, the free SMB and CIFS client and server for unix and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. -- cgit From 3db52feb1f3b2c07ce0b06ad4a7099fa6efe3fc7 Mon Sep 17 00:00:00 2001 From: Andrew Tridgell Date: Mon, 13 Dec 1999 13:27:58 +0000 Subject: first pass at updating head branch to be to be the same as the SAMBA_2_0 branch (This used to be commit 453a822a76780063dff23526c35408866d0c0154) --- README | 19 ++++++------------- 1 file changed, 6 insertions(+), 13 deletions(-) (limited to 'README') diff --git a/README b/README index d1e50585c8..70b4b76ac3 100644 --- a/README +++ b/README @@ -1,10 +1,13 @@ -This is version 2.1.0alphaX of Samba, the free SMB and CIFS client and +This is version 2.0.X of Samba, the free SMB and CIFS client and server for unix and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. >>>> Please read THE WHOLE of this file as it gives important information >>>> about the configuration and use of Samba. +NOTE: Installation instructions may be found in + docs/textdocs/UNIX_INSTALL.txt + This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file called COPYING). @@ -136,14 +139,7 @@ available on the web page. If you would like to help with the documentation (and we _need_ help!) then have a look at the mailing list samba-docs, archived at -http://samba.org/listproc/samba-docs. - - -FTP SITE --------- - -Please use a mirror site! The list of mirrors is in docs/MIRRORS.txt. -The master ftp site is samba.org in the directory pub/samba. +http://lists.samba.org/ MAILING LIST @@ -161,7 +157,7 @@ body of "subscribe samba-announce Your Name". All announcements also go to the samba list. For details of other Samba mailing lists and for access to archives, see -http://samba.org/listproc. +http://lists.samba.org/ NEWS GROUP @@ -186,6 +182,3 @@ As well as general information and documentation, this also has searchable archives of the mailing list and a user survey that shows who else is using this package. Have you registered with the survey yet? :-) -It is maintained by Paul Blackman (thanks Paul!). You can contact him -as ictinus@samba.org. - -- cgit From adb4931aa4db022d0302a4a7060643c738084f26 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 20 Dec 2001 21:25:20 +0000 Subject: couple of updates mentioned on samba@samba.org (This used to be commit 95308453b256fc51cbf1a2b2726ba8db7da1e80b) --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'README') diff --git a/README b/README index 70b4b76ac3..93c8cb133e 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is version 2.0.X of Samba, the free SMB and CIFS client and +This is a development version of Samba, the free SMB and CIFS client and server for unix and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. @@ -6,7 +6,7 @@ the Samba Team, who support the original author, Andrew Tridgell. >>>> about the configuration and use of Samba. NOTE: Installation instructions may be found in - docs/textdocs/UNIX_INSTALL.txt + docs/htmldocs/UNIX_INSTALL.html This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file -- cgit From cc79cfb498f114c8d0c70ab3d7eeb2346a3f8351 Mon Sep 17 00:00:00 2001 From: Martin Pool Date: Wed, 19 Feb 2003 00:18:25 +0000 Subject: Remove old samba-bugs address, etc. (Merge from HEAD) (This used to be commit 7e355dcf41c9aed67cb327ebbba2be3ab5d6637e) --- README | 18 ++++-------------- 1 file changed, 4 insertions(+), 14 deletions(-) (limited to 'README') diff --git a/README b/README index 93c8cb133e..b4bd9a0f57 100644 --- a/README +++ b/README @@ -92,12 +92,12 @@ If you want to contribute to the development of the software then please join the mailing list. The Samba team accepts patches (preferably in "diff -u" format, see docs/BUGS.txt for more details) and are always glad to receive feedback or suggestions to the address -samba-bugs@samba.org. We have recently put a new bug tracking -system into place which should help the throughput quite a lot. You -can also get the Samba sourcecode straight from the CVS tree - see +samba@lists.samba.org. + +You can also get the Samba sourcecode straight from the CVS tree - see http://samba.org/cvs.html. -You could also send hardware/software/money/jewelry or pizza +You could also send hardware/software/money/jewelry or pre-paid pizza vouchers directly to Andrew. The pizza vouchers would be especially welcome, in fact there is a special field in the survey for people who have paid up their pizza :-) @@ -111,16 +111,6 @@ we get. If noone tells us they like it then we'll probably move onto something else. However, as you can see from the user survey quite a lot of people do seem to like it at the moment :-) -Andrew Tridgell -Email: samba-bugs@samba.org - -3 Ballow Crescent -Macgregor, A.C.T. -2615 Australia - -Samba Team -Email: samba-bugs@samba.org - MORE INFO ========= -- cgit From 5a5f4c62d5be792f7d6decb969e2ffb45dd6ff68 Mon Sep 17 00:00:00 2001 From: Martin Pool Date: Wed, 19 Feb 2003 00:49:10 +0000 Subject: Remove old listproc address; update instructions for subscribing to the mailing list. (This used to be commit f09f374bab5385cf1a5daa573494c30feff3d41a) --- README | 60 ++++++++++++++++++++++++++++++++++++++++++++++++++++-------- 1 file changed, 52 insertions(+), 8 deletions(-) (limited to 'README') diff --git a/README b/README index b4bd9a0f57..cdc7e9e2a9 100644 --- a/README +++ b/README @@ -135,19 +135,63 @@ http://lists.samba.org/ MAILING LIST ------------ -There is a mailing list for discussion of Samba. To subscribe send -mail to listproc@samba.org with a body of "subscribe samba Your Name" -Please do NOT send this request to the list alias instead. +Please do NOT send subscription/unsubscription requests to the lists! -To send mail to everyone on the list mail to samba@listproc.anu.edu.au +There is a mailing list for discussion of Samba. For details go to + or send mail to There is also an announcement mailing list where new versions are -announced. To subscribe send mail to listproc@samba.org with a -body of "subscribe samba-announce Your Name". All announcements also -go to the samba list. +announced. To subscribe go to or send mail +to . All announcements also +go to the samba list, so you only need to be on one. For details of other Samba mailing lists and for access to archives, see -http://lists.samba.org/ + + + +MAILING LIST ETIQUETTE +---------------------- + +A few tips when submitting to this or any mailing list. + +1. Make your subject short and descriptive. Avoid the words "help" or + "Samba" in the subject. The readers of this list already know that + a) you need help, and b) you are writing about samba (of course, + you may need to distinguish between Samba PDC and other file + sharing software). Avoid phrases such as "what is" and "how do + i". Some good subject lines might look like "Slow response with + Excel files" or "Migrating from Samba PDC to NT PDC". + +2. If you include the original message in your reply, trim it so that + only the relevant lines, enough to establish context, are + included. Chances are (since this is a mailing list) we've already + read the original message. + +3. Trim irrelevant headers from the original message in your + reply. All we need to see is a) From, b) Date, and c) Subject. We + don't even really need the Subject, if you haven't changed + it. Better yet is to just preface the original message with "On + [date] [someone] wrote:". + +4. Please don't reply to or argue about spam, spam filters or viruses + on any Samba lists. We do have a spam filtering system that is + working quite well thank you very much but occasionally unwanted + messages slip through. Deal with it. + +5. Never say "Me too." It doesn't help anyone solve the + problem. Instead, if you ARE having the same problem, give more + information. Have you seen something that the other writer hasn't + mentioned, which may be helpful? + +6. If you ask about a problem, then come up with the solution on your + own or through another source, by all means post it. Someone else + may have the same problem and is waiting for an answer, but never + hears of it. + +7. Give as much *relevant* information as possible such as Samba + release number, OS, kernel version, etc... + +8. RTFM. Google. groups.google.com. NEWS GROUP -- cgit From 098fea0fa85d41576121a25e8664cdf23135b067 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 12 Jun 2003 13:10:47 +0000 Subject: fix broken link (This used to be commit ab79fac6b0ca1e2c3a8a63408869865c6d7f4304) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index cdc7e9e2a9..a61a3adcc0 100644 --- a/README +++ b/README @@ -6,7 +6,7 @@ the Samba Team, who support the original author, Andrew Tridgell. >>>> about the configuration and use of Samba. NOTE: Installation instructions may be found in - docs/htmldocs/UNIX_INSTALL.html + docs/htmldocs/install.html This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file -- cgit From d4494204fe91f8497cb2b1162a2da7c47e5273dc Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Thu, 10 Jul 2003 22:40:56 +0000 Subject: Fix typo (This used to be commit cbcb8a49b28ef4027c449562052600abe8c5d141) --- README | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) (limited to 'README') diff --git a/README b/README index a61a3adcc0..725a26523a 100644 --- a/README +++ b/README @@ -19,7 +19,7 @@ WHAT IS SMB? This is a big question. The very short answer is that it is the protocol by which a lot of -PC-related machines share files and printers and other informatiuon +PC-related machines share files and printers and other information such as lists of available files and printers. Operating systems that support this natively include Windows NT, OS/2, and Linux and add on packages that achieve the same thing are available for DOS, Windows, -- cgit From 842b6e858314c4bd791ad203b51eeb463af4110d Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Tue, 19 Aug 2003 18:42:28 +0000 Subject: updating README a little; (bug 214) (This used to be commit b9e9efbfa4eec41823446a03e313be453d1f7d3c) --- README | 89 ++++++++++++++++++++++++++++++++++++------------------------------ 1 file changed, 48 insertions(+), 41 deletions(-) (limited to 'README') diff --git a/README b/README index 725a26523a..f529610ef4 100644 --- a/README +++ b/README @@ -1,5 +1,5 @@ This is a development version of Samba, the free SMB and CIFS client and -server for unix and other operating systems. Samba is maintained by +server for UNIX and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. >>>> Please read THE WHOLE of this file as it gives important information @@ -13,35 +13,36 @@ copy of which you should have received with this software (in a file called COPYING). -WHAT IS SMB? -============ +WHAT IS SMB/CIFS? +================= This is a big question. The very short answer is that it is the protocol by which a lot of PC-related machines share files and printers and other information such as lists of available files and printers. Operating systems that -support this natively include Windows NT, OS/2, and Linux and add on -packages that achieve the same thing are available for DOS, Windows, -VMS, Unix of all kinds, MVS, and more. Apple Macs and some Web Browsers -can speak this protocol as well. Alternatives to SMB include -Netware, NFS, Appletalk, Banyan Vines, Decnet etc; many of these have -advantages but none are both public specifications and widely -implemented in desktop machines by default. - -The Common Internet Filesystem (CIFS) is what the new SMB initiative +support this natively include Windows 9x, Windows NT (and derivatives), +OS/2, Mac OS X and Linux. Add on packages that achieve the same +thing are available for DOS, Windows 3.1, VMS, Unix of all kinds, +MVS, and more. Some Web Browsers can speak this protocol as well +(smb://). Alternatives to SMB include Netware, NFS, Appletalk, +Banyan Vines, Decnet etc; many of these have advantages but none are +both public specifications and widely implemented in desktop machines +by default. + +The Common Internet File system (CIFS) is what the new SMB initiative is called. For details watch http://samba.org/cifs. WHY DO PEOPLE WANT TO USE SMB? ============================== -1. Many people want to integrate their Microsoft or IBM style desktop - machines with their Unix or VMS (etc) servers. +1. Many people want to integrate their Microsoft desktop clients + with their Unix servers. 2. Others want to integrate their Microsoft (etc) servers with Unix - or VMS (etc) servers. This is a different problem to integrating - desktop clients. + servers. This is a different problem to integrating desktop + clients. 3. Others want to replace protocols like NFS, DecNet and Novell NCP, especially when used with PCs. @@ -50,18 +51,26 @@ WHY DO PEOPLE WANT TO USE SMB? WHAT CAN SAMBA DO? ================== -Here is a very short list of what samba includes, and what it does. For -many networks this can be simply summarised by "Samba provides a complete -replacement for Windows NT, Warp, NFS or Netware servers." +Please refer to the WHATSNEW.txt included with this README for +a list of features in the latest Samba release. + +Here is a very short list of what samba includes, and what it does. +For many networks this can be simply summarized by "Samba provides +a complete replacement for Windows NT, Warp, NFS or Netware servers." - a SMB server, to provide Windows NT and LAN Manager-style file and print services to SMB clients such as Windows 95, Warp Server, smbfs and others. +- a Windows NT 4.0 Domain Controller replacement. + +- a file/print server that can act as a member of a Windows NT 4.0 + or Active Directory domain. + - a NetBIOS (rfc1001/1002) nameserver, which amongst other things gives browsing support. Samba can be the master browser on your LAN if you wish. - a ftp-like SMB client so you can access PC resources (disks and -printers) from unix, Netware and other operating systems + printers) from UNIX, Netware, and other operating systems - a tar extension to the client for backing up PCs @@ -73,16 +82,14 @@ http://samba.org/samba, and browse the user survey. Related packages include: -- smbfs, a linux-only filesystem allowing you to mount remote SMB -filesystems from PCs on your linux box. This is included as standard with +- smbfs, a Linux-only filesystem allowing you to mount remote SMB +filesystems from PCs on your Linux box. This is included as standard with Linux 2.0 and later. -- tcpdump-smb, a extension to tcpdump to allow you to investigate SMB -networking problems over netbeui and tcp/ip. +- cifsvfs, a more advanced Linux-only filesystem allowing you to mount +remote SMB filesystems from PCs on your Linux box. This is included +as standard with Linux 2.5 and later. -- smblib, a library of smb functions which are designed to make it -easy to smb-ise any particular application. See -ftp://samba.org/pub/samba/smblib. CONTRIBUTIONS @@ -90,9 +97,10 @@ CONTRIBUTIONS If you want to contribute to the development of the software then please join the mailing list. The Samba team accepts patches -(preferably in "diff -u" format, see docs/BUGS.txt for more details) -and are always glad to receive feedback or suggestions to the address -samba@lists.samba.org. +(preferably in "diff -u" format, see http://samba.org/samba/devel/ +for more details) and are always glad to receive feedback or +suggestions to the address samba@lists.samba.org. More information +on the various Samba mailing lists can be found at http://lists.samba.org/. You can also get the Samba sourcecode straight from the CVS tree - see http://samba.org/cvs.html. @@ -107,7 +115,7 @@ If you like a particular feature then look through the CVS change-log who added it, then send them an email. Remember that free software of this kind lives or dies by the response -we get. If noone tells us they like it then we'll probably move onto +we get. If no one tells us they like it then we'll probably move onto something else. However, as you can see from the user survey quite a lot of people do seem to like it at the moment :-) @@ -119,17 +127,16 @@ DOCUMENTATION ------------- There is quite a bit of documentation included with the package, -including man pages, and lots of .txt files with hints and useful +including man pages, and lots of .html files with hints and useful info. This is also available from the web page. There is a growing -collection of information under docs/faq; by the next release expect -this to be the default starting point. +collection of information under docs/. A list of Samba documentation in languages other than English is available on the web page. If you would like to help with the documentation (and we _need_ help!) then have a look at the mailing list samba-docs, archived at -http://lists.samba.org/ +http://lists.samba.org/listinfo/samba-docs/ MAILING LIST @@ -197,12 +204,12 @@ A few tips when submitting to this or any mailing list. NEWS GROUP ---------- -You might also like to look at the usenet news group -comp.protocols.smb as it often contains lots of useful info and is -frequented by lots of Samba users. The newsgroup was initially setup -by people on the Samba mailing list. It is not, however, exclusive to -Samba, it is a forum for discussing the SMB protocol (which Samba -implements). The samba list is gatewayed to this newsgroup. +You might also like to look at the usenet news group comp.protocols.smb +as it often contains lots of useful info and is frequented by lots of +Samba users. The newsgroup was initially setup by people on the Samba +mailing list. It is not, however, exclusive to Samba, it is a forum for +discussing the SMB protocol (which Samba implements). The samba list +is gatewayed to this newsgroup. WEB SITE -- cgit From 30208782e77574dbb279fe41ad97a6417b6548bf Mon Sep 17 00:00:00 2001 From: Jelmer Vernooij Date: Fri, 17 Sep 2004 17:31:31 +0000 Subject: r2390: Update some URLs and locations in README (This used to be commit 4e29698467d124663226929b485d27d3f67e0f8e) --- README | 12 ++++++------ 1 file changed, 6 insertions(+), 6 deletions(-) (limited to 'README') diff --git a/README b/README index f529610ef4..d6c5e15bdf 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is a development version of Samba, the free SMB and CIFS client and +This is a development version of Samba, the free SMB and CIFS client and server for UNIX and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. @@ -6,7 +6,7 @@ the Samba Team, who support the original author, Andrew Tridgell. >>>> about the configuration and use of Samba. NOTE: Installation instructions may be found in - docs/htmldocs/install.html + docs/htmldocs/Samba-HOWTO-Collection/install.html This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file @@ -102,16 +102,16 @@ for more details) and are always glad to receive feedback or suggestions to the address samba@lists.samba.org. More information on the various Samba mailing lists can be found at http://lists.samba.org/. -You can also get the Samba sourcecode straight from the CVS tree - see -http://samba.org/cvs.html. +You can also get the Samba sourcecode straight from the Subversion tree - see +http://samba.org/samba/subversion.html. You could also send hardware/software/money/jewelry or pre-paid pizza vouchers directly to Andrew. The pizza vouchers would be especially welcome, in fact there is a special field in the survey for people who have paid up their pizza :-) -If you like a particular feature then look through the CVS change-log -(on the web at http://samba.org/cgi-bin/cvsweb/samba) and see +If you like a particular feature then look through the Subversion change-log +(on the web at http://websvn.samba.org/cgi-bin/viewcvs.cgi) and see who added it, then send them an email. Remember that free software of this kind lives or dies by the response -- cgit From 6d7a1feef06de9001ee8928f9a674069e5a6fcbe Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 1 Feb 2006 20:29:41 +0000 Subject: r13286: changing target file in another branch (This used to be commit 91384c703cadce9ae262503958dba42389b34321) --- README | 2 ++ 1 file changed, 2 insertions(+) (limited to 'README') diff --git a/README b/README index d6c5e15bdf..55f9773d1b 100644 --- a/README +++ b/README @@ -223,3 +223,5 @@ As well as general information and documentation, this also has searchable archives of the mailing list and a user survey that shows who else is using this package. Have you registered with the survey yet? :-) + +; end of file -- cgit From ee4fc9c73ea39554c817cacdf55167ecb35e6284 Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 1 Feb 2006 20:30:46 +0000 Subject: r13287: removning readme file (This used to be commit c20ad9d8c03a15afc670dc74921e9e9530174ff6) --- README | 227 ----------------------------------------------------------------- 1 file changed, 227 deletions(-) delete mode 100644 README (limited to 'README') diff --git a/README b/README deleted file mode 100644 index 55f9773d1b..0000000000 --- a/README +++ /dev/null @@ -1,227 +0,0 @@ -This is a development version of Samba, the free SMB and CIFS client and -server for UNIX and other operating systems. Samba is maintained by -the Samba Team, who support the original author, Andrew Tridgell. - ->>>> Please read THE WHOLE of this file as it gives important information ->>>> about the configuration and use of Samba. - -NOTE: Installation instructions may be found in - docs/htmldocs/Samba-HOWTO-Collection/install.html - -This software is freely distributable under the GNU public license, a -copy of which you should have received with this software (in a file -called COPYING). - - -WHAT IS SMB/CIFS? -================= - -This is a big question. - -The very short answer is that it is the protocol by which a lot of -PC-related machines share files and printers and other information -such as lists of available files and printers. Operating systems that -support this natively include Windows 9x, Windows NT (and derivatives), -OS/2, Mac OS X and Linux. Add on packages that achieve the same -thing are available for DOS, Windows 3.1, VMS, Unix of all kinds, -MVS, and more. Some Web Browsers can speak this protocol as well -(smb://). Alternatives to SMB include Netware, NFS, Appletalk, -Banyan Vines, Decnet etc; many of these have advantages but none are -both public specifications and widely implemented in desktop machines -by default. - -The Common Internet File system (CIFS) is what the new SMB initiative -is called. For details watch http://samba.org/cifs. - - -WHY DO PEOPLE WANT TO USE SMB? -============================== - -1. Many people want to integrate their Microsoft desktop clients - with their Unix servers. - -2. Others want to integrate their Microsoft (etc) servers with Unix - servers. This is a different problem to integrating desktop - clients. - -3. Others want to replace protocols like NFS, DecNet and Novell NCP, - especially when used with PCs. - - -WHAT CAN SAMBA DO? -================== - -Please refer to the WHATSNEW.txt included with this README for -a list of features in the latest Samba release. - -Here is a very short list of what samba includes, and what it does. -For many networks this can be simply summarized by "Samba provides -a complete replacement for Windows NT, Warp, NFS or Netware servers." - -- a SMB server, to provide Windows NT and LAN Manager-style file and print - services to SMB clients such as Windows 95, Warp Server, smbfs and others. - -- a Windows NT 4.0 Domain Controller replacement. - -- a file/print server that can act as a member of a Windows NT 4.0 - or Active Directory domain. - -- a NetBIOS (rfc1001/1002) nameserver, which amongst other things gives - browsing support. Samba can be the master browser on your LAN if you wish. - -- a ftp-like SMB client so you can access PC resources (disks and - printers) from UNIX, Netware, and other operating systems - -- a tar extension to the client for backing up PCs - -- limited command-line tool that supports some of the NT administrative - functionality, which can be used on Samba, NT workstation and NT server. - -For a much better overview have a look at the web site at -http://samba.org/samba, and browse the user survey. - -Related packages include: - -- smbfs, a Linux-only filesystem allowing you to mount remote SMB -filesystems from PCs on your Linux box. This is included as standard with -Linux 2.0 and later. - -- cifsvfs, a more advanced Linux-only filesystem allowing you to mount -remote SMB filesystems from PCs on your Linux box. This is included -as standard with Linux 2.5 and later. - - - -CONTRIBUTIONS -============= - -If you want to contribute to the development of the software then -please join the mailing list. The Samba team accepts patches -(preferably in "diff -u" format, see http://samba.org/samba/devel/ -for more details) and are always glad to receive feedback or -suggestions to the address samba@lists.samba.org. More information -on the various Samba mailing lists can be found at http://lists.samba.org/. - -You can also get the Samba sourcecode straight from the Subversion tree - see -http://samba.org/samba/subversion.html. - -You could also send hardware/software/money/jewelry or pre-paid pizza -vouchers directly to Andrew. The pizza vouchers would be especially -welcome, in fact there is a special field in the survey for people who -have paid up their pizza :-) - -If you like a particular feature then look through the Subversion change-log -(on the web at http://websvn.samba.org/cgi-bin/viewcvs.cgi) and see -who added it, then send them an email. - -Remember that free software of this kind lives or dies by the response -we get. If no one tells us they like it then we'll probably move onto -something else. However, as you can see from the user survey quite a lot of -people do seem to like it at the moment :-) - - -MORE INFO -========= - -DOCUMENTATION -------------- - -There is quite a bit of documentation included with the package, -including man pages, and lots of .html files with hints and useful -info. This is also available from the web page. There is a growing -collection of information under docs/. - -A list of Samba documentation in languages other than English is -available on the web page. - -If you would like to help with the documentation (and we _need_ help!) -then have a look at the mailing list samba-docs, archived at -http://lists.samba.org/listinfo/samba-docs/ - - -MAILING LIST ------------- - -Please do NOT send subscription/unsubscription requests to the lists! - -There is a mailing list for discussion of Samba. For details go to - or send mail to - -There is also an announcement mailing list where new versions are -announced. To subscribe go to or send mail -to . All announcements also -go to the samba list, so you only need to be on one. - -For details of other Samba mailing lists and for access to archives, see - - - -MAILING LIST ETIQUETTE ----------------------- - -A few tips when submitting to this or any mailing list. - -1. Make your subject short and descriptive. Avoid the words "help" or - "Samba" in the subject. The readers of this list already know that - a) you need help, and b) you are writing about samba (of course, - you may need to distinguish between Samba PDC and other file - sharing software). Avoid phrases such as "what is" and "how do - i". Some good subject lines might look like "Slow response with - Excel files" or "Migrating from Samba PDC to NT PDC". - -2. If you include the original message in your reply, trim it so that - only the relevant lines, enough to establish context, are - included. Chances are (since this is a mailing list) we've already - read the original message. - -3. Trim irrelevant headers from the original message in your - reply. All we need to see is a) From, b) Date, and c) Subject. We - don't even really need the Subject, if you haven't changed - it. Better yet is to just preface the original message with "On - [date] [someone] wrote:". - -4. Please don't reply to or argue about spam, spam filters or viruses - on any Samba lists. We do have a spam filtering system that is - working quite well thank you very much but occasionally unwanted - messages slip through. Deal with it. - -5. Never say "Me too." It doesn't help anyone solve the - problem. Instead, if you ARE having the same problem, give more - information. Have you seen something that the other writer hasn't - mentioned, which may be helpful? - -6. If you ask about a problem, then come up with the solution on your - own or through another source, by all means post it. Someone else - may have the same problem and is waiting for an answer, but never - hears of it. - -7. Give as much *relevant* information as possible such as Samba - release number, OS, kernel version, etc... - -8. RTFM. Google. groups.google.com. - - -NEWS GROUP ----------- - -You might also like to look at the usenet news group comp.protocols.smb -as it often contains lots of useful info and is frequented by lots of -Samba users. The newsgroup was initially setup by people on the Samba -mailing list. It is not, however, exclusive to Samba, it is a forum for -discussing the SMB protocol (which Samba implements). The samba list -is gatewayed to this newsgroup. - - -WEB SITE --------- - -A Samba WWW site has been setup with lots of useful info. Connect to: - -http://samba.org/samba/ - -As well as general information and documentation, this also has searchable -archives of the mailing list and a user survey that shows who else is using -this package. Have you registered with the survey yet? :-) - - -; end of file -- cgit From af03523cec7ed4c5cd265d53f4873544c68671db Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Wed, 1 Feb 2006 20:31:28 +0000 Subject: r13288: readding readme file (This used to be commit f1ab089b19fa631d38b81230466b0e2b7aa49a8d) --- README | 225 +++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 225 insertions(+) create mode 100644 README (limited to 'README') diff --git a/README b/README new file mode 100644 index 0000000000..686d1557a7 --- /dev/null +++ b/README @@ -0,0 +1,225 @@ +This is thre release version of Samba, the free SMB and CIFS client and +server for UNIX and other operating systems. Samba is maintained by +the Samba Team, who support the original author, Andrew Tridgell. + +>>>> Please read THE WHOLE of this file as it gives important information +>>>> about the configuration and use of Samba. + +NOTE: Installation instructions may be found in + docs/htmldocs/Samba-HOWTO-Collection/install.html + +This software is freely distributable under the GNU public license, a +copy of which you should have received with this software (in a file +called COPYING). + + +WHAT IS SMB/CIFS? +================= + +This is a big question. + +The very short answer is that it is the protocol by which a lot of +PC-related machines share files and printers and other information +such as lists of available files and printers. Operating systems that +support this natively include Windows 9x, Windows NT (and derivatives), +OS/2, Mac OS X and Linux. Add on packages that achieve the same +thing are available for DOS, Windows 3.1, VMS, Unix of all kinds, +MVS, and more. Some Web Browsers can speak this protocol as well +(smb://). Alternatives to SMB include Netware, NFS, Appletalk, +Banyan Vines, Decnet etc; many of these have advantages but none are +both public specifications and widely implemented in desktop machines +by default. + +The Common Internet File system (CIFS) is what the new SMB initiative +is called. For details watch http://samba.org/cifs. + + +WHY DO PEOPLE WANT TO USE SMB? +============================== + +1. Many people want to integrate their Microsoft desktop clients + with their Unix servers. + +2. Others want to integrate their Microsoft (etc) servers with Unix + servers. This is a different problem to integrating desktop + clients. + +3. Others want to replace protocols like NFS, DecNet and Novell NCP, + especially when used with PCs. + + +WHAT CAN SAMBA DO? +================== + +Please refer to the WHATSNEW.txt included with this README for +a list of features in the latest Samba release. + +Here is a very short list of what samba includes, and what it does. +For many networks this can be simply summarized by "Samba provides +a complete replacement for Windows NT, Warp, NFS or Netware servers." + +- a SMB server, to provide Windows NT and LAN Manager-style file and print + services to SMB clients such as Windows 95, Warp Server, smbfs and others. + +- a Windows NT 4.0 Domain Controller replacement. + +- a file/print server that can act as a member of a Windows NT 4.0 + or Active Directory domain. + +- a NetBIOS (rfc1001/1002) nameserver, which amongst other things gives + browsing support. Samba can be the master browser on your LAN if you wish. + +- a ftp-like SMB client so you can access PC resources (disks and + printers) from UNIX, Netware, and other operating systems + +- a tar extension to the client for backing up PCs + +- limited command-line tool that supports some of the NT administrative + functionality, which can be used on Samba, NT workstation and NT server. + +For a much better overview have a look at the web site at +http://samba.org/samba, and browse the user survey. + +Related packages include: + +- smbfs, a Linux-only filesystem allowing you to mount remote SMB +filesystems from PCs on your Linux box. This is included as standard with +Linux 2.0 and later. + +- cifsvfs, a more advanced Linux-only filesystem allowing you to mount +remote SMB filesystems from PCs on your Linux box. This is included +as standard with Linux 2.5 and later. + + + +CONTRIBUTIONS +============= + +If you want to contribute to the development of the software then +please join the mailing list. The Samba team accepts patches +(preferably in "diff -u" format, see http://samba.org/samba/devel/ +for more details) and are always glad to receive feedback or +suggestions to the address samba@lists.samba.org. More information +on the various Samba mailing lists can be found at http://lists.samba.org/. + +You can also get the Samba sourcecode straight from the Subversion tree - see +http://samba.org/samba/subversion.html. + +You could also send hardware/software/money/jewelry or pre-paid pizza +vouchers directly to Andrew. The pizza vouchers would be especially +welcome, in fact there is a special field in the survey for people who +have paid up their pizza :-) + +If you like a particular feature then look through the Subversion change-log +(on the web at http://websvn.samba.org/cgi-bin/viewcvs.cgi) and see +who added it, then send them an email. + +Remember that free software of this kind lives or dies by the response +we get. If no one tells us they like it then we'll probably move onto +something else. However, as you can see from the user survey quite a lot of +people do seem to like it at the moment :-) + + +MORE INFO +========= + +DOCUMENTATION +------------- + +There is quite a bit of documentation included with the package, +including man pages, and lots of .html files with hints and useful +info. This is also available from the web page. There is a growing +collection of information under docs/. + +A list of Samba documentation in languages other than English is +available on the web page. + +If you would like to help with the documentation (and we _need_ help!) +then have a look at the mailing list samba-docs, archived at +http://lists.samba.org/listinfo/samba-docs/ + + +MAILING LIST +------------ + +Please do NOT send subscription/unsubscription requests to the lists! + +There is a mailing list for discussion of Samba. For details go to + or send mail to + +There is also an announcement mailing list where new versions are +announced. To subscribe go to or send mail +to . All announcements also +go to the samba list, so you only need to be on one. + +For details of other Samba mailing lists and for access to archives, see + + + +MAILING LIST ETIQUETTE +---------------------- + +A few tips when submitting to this or any mailing list. + +1. Make your subject short and descriptive. Avoid the words "help" or + "Samba" in the subject. The readers of this list already know that + a) you need help, and b) you are writing about samba (of course, + you may need to distinguish between Samba PDC and other file + sharing software). Avoid phrases such as "what is" and "how do + i". Some good subject lines might look like "Slow response with + Excel files" or "Migrating from Samba PDC to NT PDC". + +2. If you include the original message in your reply, trim it so that + only the relevant lines, enough to establish context, are + included. Chances are (since this is a mailing list) we've already + read the original message. + +3. Trim irrelevant headers from the original message in your + reply. All we need to see is a) From, b) Date, and c) Subject. We + don't even really need the Subject, if you haven't changed + it. Better yet is to just preface the original message with "On + [date] [someone] wrote:". + +4. Please don't reply to or argue about spam, spam filters or viruses + on any Samba lists. We do have a spam filtering system that is + working quite well thank you very much but occasionally unwanted + messages slip through. Deal with it. + +5. Never say "Me too." It doesn't help anyone solve the + problem. Instead, if you ARE having the same problem, give more + information. Have you seen something that the other writer hasn't + mentioned, which may be helpful? + +6. If you ask about a problem, then come up with the solution on your + own or through another source, by all means post it. Someone else + may have the same problem and is waiting for an answer, but never + hears of it. + +7. Give as much *relevant* information as possible such as Samba + release number, OS, kernel version, etc... + +8. RTFM. Google. groups.google.com. + + +NEWS GROUP +---------- + +You might also like to look at the usenet news group comp.protocols.smb +as it often contains lots of useful info and is frequented by lots of +Samba users. The newsgroup was initially setup by people on the Samba +mailing list. It is not, however, exclusive to Samba, it is a forum for +discussing the SMB protocol (which Samba implements). The samba list +is gatewayed to this newsgroup. + + +WEB SITE +-------- + +A Samba WWW site has been setup with lots of useful info. Connect to: + +http://samba.org/samba/ + +As well as general information and documentation, this also has searchable +archives of the mailing list and a user survey that shows who else is using +this package. Have you registered with the survey yet? :-) + -- cgit From feb50dae419380f200bc127632be88637788dc8f Mon Sep 17 00:00:00 2001 From: John Terpstra Date: Sat, 4 Feb 2006 05:42:29 +0000 Subject: r13327: Update install.html location & fix typo. (This used to be commit 77fb6998510ceab502548ea3b20541136b37b952) --- README | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'README') diff --git a/README b/README index 686d1557a7..ac86326b36 100644 --- a/README +++ b/README @@ -1,4 +1,4 @@ -This is thre release version of Samba, the free SMB and CIFS client and +This is the release version of Samba, the free SMB and CIFS client and server for UNIX and other operating systems. Samba is maintained by the Samba Team, who support the original author, Andrew Tridgell. @@ -6,7 +6,7 @@ the Samba Team, who support the original author, Andrew Tridgell. >>>> about the configuration and use of Samba. NOTE: Installation instructions may be found in - docs/htmldocs/Samba-HOWTO-Collection/install.html + docs/htmldocs/Samba3-HOWTO/install.html This software is freely distributable under the GNU public license, a copy of which you should have received with this software (in a file -- cgit From 9a9a7e2de465298661ffc6c620be2ed7adb7fdcd Mon Sep 17 00:00:00 2001 From: Gerald Carter Date: Thu, 26 Jul 2007 12:08:13 +0000 Subject: r24055: Remove a reference to the outdated samba-docs mailing list. This entire README really needs to be overhauled at some point. (This used to be commit c08d85a5f1a66e8fdd0b33a1d8d1a2c9ce9c1a35) --- README | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'README') diff --git a/README b/README index ac86326b36..1d55a1040c 100644 --- a/README +++ b/README @@ -134,9 +134,9 @@ collection of information under docs/. A list of Samba documentation in languages other than English is available on the web page. -If you would like to help with the documentation (and we _need_ help!) -then have a look at the mailing list samba-docs, archived at -http://lists.samba.org/listinfo/samba-docs/ +If you would like to help with the documentation, please coodinate +on the samba@samba.org mailing list. See the next section for details +on subscribing to samba mailing lists. MAILING LIST -- cgit From e3e34c9a32a29c25ead1011792004ade3f61e4c6 Mon Sep 17 00:00:00 2001 From: Volker Lendecke Date: Tue, 22 Jan 2008 13:42:44 +0100 Subject: replace svn references with git ones in Readme (This used to be commit e6c92b62a4791fd5b530e6e52e4386e837bd7994) --- README | 8 ++++---- 1 file changed, 4 insertions(+), 4 deletions(-) (limited to 'README') diff --git a/README b/README index 1d55a1040c..e6634febc0 100644 --- a/README +++ b/README @@ -102,16 +102,16 @@ for more details) and are always glad to receive feedback or suggestions to the address samba@lists.samba.org. More information on the various Samba mailing lists can be found at http://lists.samba.org/. -You can also get the Samba sourcecode straight from the Subversion tree - see -http://samba.org/samba/subversion.html. +You can also get the Samba sourcecode straight from the git repository - see +http://wiki.samba.org/index.php/Using_Git_for_Samba_Development. You could also send hardware/software/money/jewelry or pre-paid pizza vouchers directly to Andrew. The pizza vouchers would be especially welcome, in fact there is a special field in the survey for people who have paid up their pizza :-) -If you like a particular feature then look through the Subversion change-log -(on the web at http://websvn.samba.org/cgi-bin/viewcvs.cgi) and see +If you like a particular feature then look through the git change-log +(on the web at http://gitweb.samba.org/?p=samba.git;a=summary) and see who added it, then send them an email. Remember that free software of this kind lives or dies by the response -- cgit