diff options
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 137 |
1 files changed, 137 insertions, 0 deletions
diff --git a/README.md b/README.md new file mode 100644 index 0000000..cf55b03 --- /dev/null +++ b/README.md @@ -0,0 +1,137 @@ +About Samba +=========== + +Samba is the standard Windows interoperability suite of +programs for Linux and Unix. +Samba is Free Software licensed under the GNU General Public License and +the Samba project is a member of the Software Freedom Conservancy. +Since 1992, Samba has provided secure, stable and fast file and print services +for all clients using the SMB/CIFS protocol, such as all versions of DOS +and Windows, OS/2, Linux and many others. +Samba is an important component to seamlessly integrate Linux/Unix Servers and +Desktops into Active Directory environments. It can function both as a +domain controller or as a regular domain member. + + +For the AD DC implementation a full HOWTO is provided at: + https://wiki.samba.org/index.php/Samba4/HOWTO + +Community guidelines can be read at: + https://wiki.samba.org/index.php/How_to_do_Samba:_Nicely + +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). + + + +CONTRIBUTIONS +============= + +Please see https://wiki.samba.org/index.php/Contribute +for detailed set-by-step instructions on how to submit a patch +for Samba via GitLab. + +Samba's GitLab mirror is at https://gitlab.com/samba-team/samba + +OUR CONTRIBUTORS +================ + +See https://www.samba.org/samba/team/ for details of the Samba Team, +as well as details of all those currently active in Samba development. + +If you like a particular feature then look through the git change-log +(on the web at https://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 +we get. If no one tells us they like it then we'll probably move onto +something else. + + +MORE INFO +========= + +DOCUMENTATION +------------- + +There is quite a bit of documentation included with the package, +including man pages and the wiki at https://wiki.samba.org + +If you would like to help with our documentation, please contribute +that improved content to the wiki, we are moving as much content there +as possible. + + +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 +<https://lists.samba.org/> or send mail to <samba-subscribe@lists.samba.org> + +There is also an announcement mailing list where new versions are +announced. To subscribe go to <https://lists.samba.org/> or send mail +to <samba-announce-subscribe@lists.samba.org>. 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 +<https://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. + + +WEBSITE +------- + +A Samba website has been setup with lots of useful info. Connect to: + +https://www.samba.org/ + +As well as general information and documentation, this also has searchable +archives of the mailing list and links to other useful resources such as +the wiki. |