Developers Index

Developers

From GlusterDocumentation

Contributing to the Gluster community

Are you itching to send in patches and participate as a developer in the Gluster community? Here are a number of starting points for getting involved. We don't require a signed contributor license agreement or copyright assignment, but we do require a "signed-off-by" line on each code check-in.

• [Simplified Developer Workflow](./Simplified Development Workflow.md)
  • A simpler and faster intro to developing with GlusterFS, than the doc below.
• [Developer Workflow](./Development Workflow.md) - this tells you about our patch requirements, tools we use, and more. Required reading if you want to contribute code.
• License Change - we recently changed the client library code to a dual license under the GPL v2 and the LGPL v3 or later
• GlusterFS Coding Standards

Compiling Gluster

• [Compiling RPMS](./Compiling RPMS.md) - Step by step instructions for compiling Gluster RPMS
• [Building GlusterFS](./Building GlusterFS.md) - How to compile Gluster from source code. Including instructions for Ubuntu.

Developing

• Projects - Ideas for projects you could create
• [Language Bindings](./Language Bindings.md) - Connect to GlusterFS using various language bindings
• [EasyFix_Bugs](./Easy Fix Bugs.md) - Easy to fix bugs of GlusterFS. One of the best place to start contributing to GlusterFS.
• [Fixing issues reported by tools for static code analysis](./Fixing issues reported by tools for static code analysis.md)
  • This is a good starting point for developers to fix bugs in GlusterFS project.
• [Backport Wishlist](./Backport Wishlist.md) - Problems fixed in the master branch might need to get fixed in stable release branches too. The [Backport Guidelines](./Backport Guidelines.md) describe the steps that branches too.

Adding File operations

• Steps to be followed when adding a new FOP to GlusterFS

Automatic File Replication

• Cluster/afr translator
• History of Locking in AFR
• Self heal Daemon

Data Structures

• inode data structure
• iobuf data structure
• mem-pool data structure

Find the gfapi symbol versions here

Daemon Management Framework

• How to introduce new daemons using daemon management framework

Translators

• Block Device Tanslator
• Performance/write-Behind Translator
• Translator Development
• Storage/posix Translator
• Compression translator

Testing/Debugging

• Unit Tests in GlusterFS
• [Using the Gluster Test Framework](./Using Gluster Test Framework.md) - Step by step instructions for running the Gluster Test Framework
• [Our Jenkins Infrastructure](./Jenkins Infrastructure.md) - A braindump of the Jenkins infrastructure we have in place for automated testing
• [Manual steps for setting up a Jenkins slave VM in Rackspace](./Jenkins Manual Setup.md) - Steps for setting up a slave VM in Rackspace
• Coredump Analysis - Steps to analize coredumps generated by regression machines.

Bug Handling

• [Bug reporting guidelines](./Bug Reporting Guidelines.md) - Guideline for reporting a bug in GlusterFS
• [Bug triage guidelines](./Bug Triage.md) - Guideline on how to triage bugs for GlusterFS
• [Bug report life cycle in Bugzilla](./Bug report Life Cycle.md) - Information about bug life cycle

Patch Acceptance

• The [Guidelines For Maintainers](./Guidelines For Maintainers.md) explains when maintainers can merge patches.

Release Process

• Versioning
• [GlusterFS Release Process](./GlusterFS Release process.md) - Our release process / checklist