git.sur5r.net Git - bacula/docs/blob - docs/developers/file.tex

   1 %%
   2 %%
   3
   4 \chapter{File Services Daemon}
   5 \label{_ChapterStart11}
   6 \index{File Services Daemon }
   7 \index{Daemon!File Services }
   8 \addcontentsline{toc}{section}{File Services Daemon}
   9
  10 Please note, this section is somewhat out of date as the code has evolved
  11 significantly. The basic idea has not changed though.
  12
  13 This chapter is intended to be a technical discussion of the File daemon
  14 services and as such is not targeted at end users but rather at developers and
  15 system administrators that want or need to know more of the working details of
  16 {\bf Bacula}.
  17
  18 The {\bf Bacula File Services} consist of the programs that run on the system
  19 to be backed up and provide the interface between the Host File system and
  20 Bacula -- in particular, the Director and the Storage services.
  21
  22 When time comes for a backup, the Director gets in touch with the File daemon
  23 on the client machine and hands it a set of ``marching orders'' which, if
  24 written in English, might be something like the following:
  25
  26 OK, {\bf File daemon}, it's time for your daily incremental backup. I want you
  27 to get in touch with the Storage daemon on host archive.mysite.com and perform
  28 the following save operations with the designated options. You'll note that
  29 I've attached include and exclude lists and patterns you should apply when
  30 backing up the file system. As this is an incremental backup, you should save
  31 only files modified since the time you started your last backup which, as you
  32 may recall, was 2000-11-19-06:43:38. Please let me know when you're done and
  33 how it went. Thank you.
  34
  35 So, having been handed everything it needs to decide what to dump and where to
  36 store it, the File daemon doesn't need to have any further contact with the
  37 Director until the backup is complete providing there are no errors. If there
  38 are errors, the error messages will be delivered immediately to the Director.
  39 While the backup is proceeding, the File daemon will send the file coordinates
  40 and data for each file being backed up to the Storage daemon, which will in
  41 turn pass the file coordinates to the Director to put in the catalog.
  42
  43 During a {\bf Verify} of the catalog, the situation is different, since the
  44 File daemon will have an exchange with the Director for each file, and will
  45 not contact the Storage daemon.
  46
  47 A {\bf Restore} operation will be very similar to the {\bf Backup} except that
  48 during the {\bf Restore} the Storage daemon will not send storage coordinates
  49 to the Director since the Director presumably already has them. On the other
  50 hand, any error messages from either the Storage daemon or File daemon will
  51 normally be sent directly to the Directory (this, of course, depends on how
  52 the Message resource is defined).
  53
  54 \section{Commands Received from the Director for a Backup}
  55 \index{Backup!Commands Received from the Director for a }
  56 \index{Commands Received from the Director for a Backup }
  57 \addcontentsline{toc}{subsection}{Commands Received from the Director for a
  58 Backup}
  59
  60 To be written ...
  61
  62 \section{Commands Received from the Director for a Restore}
  63 \index{Commands Received from the Director for a Restore }
  64 \index{Restore!Commands Received from the Director for a }
  65 \addcontentsline{toc}{subsection}{Commands Received from the Director for a
  66 Restore}
  67
  68 To be written ...