Warning: This document is for the development version of Bareos Documentation. The main version is bareos-23.

Developer Guide

• Bareos Developer Notes
  • History
  • Contributions
  • Patches
  • Bug Database
    • Reporting security issues
  • Memory Leaks
  • Guiding Principles
  • Automatic Sourcecode Formatting
  • Formatting exceptions
  • Sourcecode Comments
  • Do’s
  • Don’ts
• Build And Test Bareos
  • Building the documentation
  • Building the test-environment
    • Configure (cmake) build settings
    • Using ccache (compiler cache)
  • Systemtests
    • Run all system tests
    • Run a single system test
• Automatic Version Generation
  • What is this about?
  • How does it work?
    • CMake Variable
    • BareosVersion.cmake
      • Generating BareosVersion.cmake
    • Git Metadata
  • Troubleshooting
    • No git
    • Not a git repository
    • Git repository missing tags
    • Building in the wrong directory
    • Last resort
• Releasing Bareos
  • Deciding for a version number
  • Preparing the release notes
  • Update version-dependent files
    • version.map.in
  • Prepare the git commits and tags
    • Special considerations for major versions
  • Publishing the release
  • Updating GitHub Release
• Git Workflow
  • Getting new code or changes into Bareos
  • Releases and Backporting
  • Feature Branches
  • Commits
    • Commit message guideline
• Message Classes
  • Memory Messages
  • Debug Messages
  • Job Messages
    • Special Cases
  • Queued Job Messages
  • Error Messages
• Bareos FD Plugin API
  • Normal vs Command vs Options Plugins
  • Loading Plugins
  • loadPlugin
  • Plugin Entry Points
    • newPlugin(bpContext *ctx)
    • freePlugin(bpContext *ctx)
    • getPluginValue(bpContext *ctx, pVariable var, void *value)
    • setPluginValue(bpContext *ctx, pVariable var, void *value)
    • handlePluginEvent(bpContext *ctx, bEvent *event, void *value)
    • startBackupFile(bpContext *ctx, struct save_pkt *sp)
    • endBackupFile(bpContext *ctx)
    • startRestoreFile(bpContext *ctx, const char *cmd)
    • createFile(bpContext *ctx, struct restore_pkt *rp)
    • setFileAttributes(bpContext *ctx, struct restore_pkt *rp)
    • endRestoreFile(bpContext *ctx)
    • pluginIO(bpContext *ctx, struct io_pkt *io)
    • bool checkFile(bpContext *ctx, char *fname)
  • Bareos Plugin Entrypoints
    • bRC registerBareosEvents(bpContext *ctx, …)
    • bRC getBareosValue(bpContext *ctx, bVariable var, void *value)
    • bRC setBareosValue(bpContext *ctx, bVariable var, void *value)
    • bRC JobMessage(bpContext *ctx, const char *file, int line, int type, utime_t mtime, const char *fmt, …)
    • bRC DebugMessage(bpContext *ctx, const char *file, int line, int level, const char *fmt, …)
    • void bareosMalloc(bpContext *ctx, const char *file, int line, size_t size)
    • void bareosFree(bpContext *ctx, const char *file, int line, void *mem)
• Platform Support
  • General
  • Requirements to become a Supported Platform
• Daemon Protocol
  • General
  • Low Level Network Protocol
  • General Daemon Protocol
  • The Protocol Used Between the Director and the Storage Daemon
  • The Protocol Used Between the Director and the File Daemon
  • The Save Protocol Between the File Daemon and the Storage Daemon
    • Command and Control Information
    • Data Information
• File Services Daemon
  • Commands Received from the Director for a Backup
  • Commands Received from the Director for a Restore
• Storage Daemon Design
  • SD Design Introduction
  • SD Development Outline
  • SD Connections and Sessions
    • SD Append Requests
    • SD Read Requests
  • SD Data Structures
• Catalog Services
  • General
    • Filenames and Maximum Filename Length
    • Database Table Design
  • Database Tables
    • Path
    • File
    • Job
    • FileSet
    • JobMedia
    • Device
      • Tape Volume
      • Other Volume
    • Media (Volume)
    • Pool
    • Client
    • Storage
    • Counters
    • Log
    • Location
    • LocationLog
    • Version
    • BaseFiles
  • UML Diagram of Database Schema
• Configuration Parser
  • Introduction
  • Class Model of Storage Daemon Resources
• Storage Media Output Format
  • General
  • Definitions
  • Overall Format
    • Storage Daemon File Output Format
  • Serialization
  • Block Header
  • Record Header
  • Volume Label Format
  • Session Label
  • Overall Storage Format
  • Examine Volumes
    • bls command
  • Unix File Attributes
  • Old Deprecated Tape Format
• Bareos Porting Notes
  • Porting Requirements
• API
  • General
    • Minimal Code in Console Program
    • GUI Interface is Difficult
  • dot commands
  • API Modes
    • API mode 0 (off)
    • API mode 1 (on)
    • API mode 2 (json)
      • Examples
        • Example of a JSON-RPC Error Response
  • Bvfs API
    • General notes
    • Get dependent jobs from a given JobId
    • Generating Bvfs cache
    • List directories
    • List files
      • API mode 0
      • API mode 1
      • API mode 2
    • Get all versions of a specific file
    • Restore set of files
    • Cleanup after Restore
    • Clearing the BVFS Cache
    • Example for directory browsing using bvfs
• TLS
  • Introduction
  • TLS Handshake before Bareos 18.2
  • TLS Configuration Implementation
  • TLS API Implementation
• PAM
• Tests
  • Unit Tests
    • Adding a new Test
• Bareos Regression Testing
  • Setting up Regession Testing
  • Running the Regression Script
    • Setting the Configuration Parameters
    • Building the Test Bareos
    • Setting up your SQL engine
    • Running the Disk Only Regression
    • Other Tests
    • If a Test Fails
  • Testing a Binary Installation
  • Running a Single Test
  • Writing a Regression Test
    • Running the Tests by Hand
    • Directory Structure
    • Adding a New Test
    • Running a Test Under The Debugger
• Bareos Memory Management
  • General
    • Statically Allocated Memory
    • Dynamically Allocated Memory
    • Pooled and Non-pooled Memory
      • Types of Memory Pool:
      • Getting Memory:
      • Releasing Memory:
      • Determining the Memory Size:
      • Resizing Pool Memory:
      • Automatic Size Adjustment:
      • Releasing All Pooled Memory:
      • Pooled Memory Statistics:
• TCP/IP Network Protocol
  • Introduction
  • Network Routines
    • bnet and Threads
    • bnet_open
    • bnet_send
    • bnet_fsend
    • is_bnet_error
    • is_bnet_stop
    • bnet_recv
    • bnet_sig
    • bnet_strerror
    • bnet_close
    • Becoming a Server
  • Higher Level Conventions
  • Network startup activity
  • Debugging
  • Network Sequence Diagrams
    • Backup of a Single File
      • Overview
      • Detailed Diagram
    • Restore of a Single File
      • Overview single file restore
      • Detailed Diagram single file restore
    • Migration of a Single Volume
      • Overview single volume migration
      • Detailed Diagram single volume migration
    • Verify of a Single File (Mode: Volume to Catalog)
      • Overview single file verify
      • Detailed Diagram single file verify
• Director Console Output
  • object_key_value
  • decoration
  • messages
  • Objects and Arrays
    • named objects
    • nameless objects
    • arrays
  • Example
  • Example with 3 level structure
• Reservation
  • Introduction
    • Diagram Conventions
    • UseDeviceCmd
    • ReserveDevice
• Job Execution
  • Introduction
  • Job setup and start
  • Simple backup job
    • Overview simple backup job
    • Detailed View simple backup job
  • Simple restore job
    • Overview simple restore job
    • Detailed View simple restore job
  • Local copy or migrate job
    • Overview local copy job
    • Detailed View local copy job
  • Remote copy or migrate job
    • Overview remote copy job
    • Detailed View remote copy job
• Python
  • Automatic Sourcecode Formatting
• Webui
  • Command usage in modules and the according ACL requirements