Difference between revisions of "Developer Documentation"

From SambaWiki
Jump to: navigation, search
m (VFS)
(add link to ifdef/configure changes page)
 
(22 intermediate revisions by 7 users not shown)
Line 6: Line 6:
  
 
* [[CodeReview|Doing code review]]
 
* [[CodeReview|Doing code review]]
 
* [[Using_Git_for_Samba_Development|Using Git for Samba Development]]
 
  
 
* [[ActiveProjects|Active projects]]
 
* [[ActiveProjects|Active projects]]
 
  
  
 
= Release planning =
 
= Release planning =
  
* [[Samba_Release_Planning|Samba release planning]]
+
* [[Samba_Release_Planning|Samba release planning]] (including the [[Samba_Release_Planning#Release_Branch_Checkin_Procedure| Policy and steps required for checkins to branches]])
 
 
* [[Branch_Policy|Policy on checkins to branches]]
 
  
 
* [[Samba_Features_added/changed_(by_release)|Samba Features added/changed (by release)]]
 
* [[Samba_Features_added/changed_(by_release)|Samba Features added/changed (by release)]]
Line 24: Line 19:
  
  
 +
= Source code =
 +
 +
Samba development is stored in the [https://www.git-scm.com/ Git] SCM system.  See [[Using Git for Samba Development]] for more detail on how Samba uses Git.
 +
 +
Two web interfaces are:
 +
* [https://git.samba.org/?p=samba.git;a=heads Samba's own GitWeb] ([https://git.samba.org/?p=samba.git;a=shortlog;h=refs/heads/master latest changes in the master branch])
 +
* [https://github.com/samba-team/samba Official Samba GitHub Mirror]
  
= Source code =
 
  
* GitWeb
 
  
:* [http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v4-0-test v4-0-test] (branch for next 4.0.x release)
+
= Debugging / Testing =
  
:* [http://gitweb.samba.org/?p=samba.git;a=shortlog;h=v4-0-stable v4-0-stable] (branch for current 4.0.x release)
+
* [[The_Samba_Selftest_System|The Samba Selftest System]]
  
:* [http://gitweb.samba.org/?p=samba.git;a=shortlog;h=master master] (current Samba development for future releases)
+
* [[Samba CI on gitlab]]
  
: For more info on available branches, as well how to obtain the sources via a Git client, see the [http://www.samba.org/samba/devel samba.org devel page].
+
* [[Writing_Torture_Tests|Writing Torture Tests]]
  
 +
* [[Writing_Python_Tests|Writing Python Tests]]
  
 +
* [[Writing_cmocka_Tests|Writing cmocka Tests]]
  
= Debugging / Testing =
+
* [[Writing_Shell_Tests|Writing Shell Tests]]
  
* [[Writing_Torture_Tests|Writing Torture Tests]]
+
* [[Writing_Perl_Tests|Writing Perl Tests]]
  
 
* [[WinTest|Testing against Windows using WinTest]]
 
* [[WinTest|Testing against Windows using WinTest]]
Line 54: Line 56:
  
 
* [[KernelClientTesting|How to test the Linux kernel client against Samba]]
 
* [[KernelClientTesting|How to test the Linux kernel client against Samba]]
 +
 +
* [[Saving_RPC_FAULTs|Saving packets that failed to parse to test IDL fixes using ndrdump]]
 +
 +
* [[Testing removal of ifdef or configure checks|Testing removal of #ifdef or configure checks]]
  
 
= Bug reporting =  
 
= Bug reporting =  
Line 73: Line 79:
 
* [http://www.samba.org/~sharpe/The-Samba-VFS.pdf Writing a Samba VFS]
 
* [http://www.samba.org/~sharpe/The-Samba-VFS.pdf Writing a Samba VFS]
 
* [[The new version of Writing a Samba VFS]] (for Samba 3.6 and earlier)
 
* [[The new version of Writing a Samba VFS]] (for Samba 3.6 and earlier)
* [Writing a Samba VFS Module for Samba 4.0 and above]
+
* [[Writing a Samba VFS Module]] (for Samba 4.0 and above)
  
= Clustered Samba =
 
  
* [[Clustered_Samba|Clustered Samba]]
 
  
* [[CTDB_Project|CTDB Project]]
+
= Clustered Samba =
  
 +
* [[CTDB_and_Clustered_Samba|CTDB and Clustered Samba]]
  
 +
* [[New_clustering_features_in_SMB3_and_Samba|New clustering features in SMB3 and Samba]]
  
 
= Building Samba =
 
= Building Samba =
Line 130: Line 136:
  
 
* [http://download.samba.org/pub/samba/rc/ Development Releases of Samba4 (technology previews, alphas, betas, release candidates)]
 
* [http://download.samba.org/pub/samba/rc/ Development Releases of Samba4 (technology previews, alphas, betas, release candidates)]
 +
 +
 +
 +
= Academic Writings etc. =
 +
 +
* [https://www.samba.org/samba/news/articles/gensec-white-paper.pdf GENSEC white paper (2005)]
 +
 +
* [https://www.samba.org/samba/news/articles/abartlet_thesis.pdf Thesis on Samba (2005)]
 +
 +
* [https://www.samba.org/~metze/presentations/2007/thesis/StefanMetzmacher_Bachelorthesis_ENG_Draft-9811557.pdf Thesis on Samba replication (2007)]
 +
 +
* [https://www.samba.org/samba/news/articles/samba3-4_integration.pdf Integration of Samba 3 & Samba 4 (2005)]
 +
 +
* [http://is.muni.cz/th/359290/fi_b/thesis.pdf Thesis on Talloc (2012)]

Latest revision as of 01:14, 27 April 2019

How can I contribute


Release planning


Source code

Samba development is stored in the Git SCM system. See Using Git for Samba Development for more detail on how Samba uses Git.

Two web interfaces are:


Debugging / Testing

Bug reporting


Presentations


VFS


Clustered Samba

Building Samba


Building packages


Google Summer of Code


Historical Documentation on the Development of Samba4

  • Franky: A Hybrid Samba Active Directory Controller (outdated!)


Academic Writings etc.