venti.conf 1.5 KB

1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465
  1. .TH VENTI.CONF 6
  2. .SH NAME
  3. venti.conf \- a venti configuration file
  4. .SH DESCRIPTION
  5. A venti configuration file enumerates the various index sections and
  6. arenas that constitute a venti system.
  7. The components are indicated by the name of the file, typically
  8. a disk partition, in which they reside. The configuration
  9. file is the only location that file names are used. Internally,
  10. venti uses the names assigned when the components were formatted
  11. with
  12. .IR fmtarenas (8)
  13. or
  14. .IR fmtisect (8).
  15. In particular, by changing the configuration a
  16. component can be copied to a different file.
  17. .PP
  18. The configuration file consists of lines in the form described below.
  19. Lines starting with
  20. .B #
  21. are comments.
  22. .TP
  23. .BI index " name
  24. Names the index for the system.
  25. .TP
  26. .BI arenas " file
  27. .I File
  28. contains a collection of arenas, formatted using
  29. .IR fmtarenas (8).
  30. .TP
  31. .BI isect " file
  32. .I File
  33. contains an index section, formatted using
  34. .IR fmtisect (8).
  35. .PP
  36. After formatting a venti system using
  37. .IR fmtindex (8),
  38. the order of arenas and index sections should not be changed.
  39. Additional arenas can be appended to the configuration.
  40. .SH EXAMPLE
  41. .EX
  42. # a sample venti configuration file
  43. #
  44. # formatted with
  45. # venti/fmtarenas arena. /tmp/disks/arenas
  46. # venti/fmtisect isect0 /tmp/disks/isect0
  47. # venti/fmtisect isect1 /tmp/disks/isect1
  48. # venti/fmtindex venti.conf
  49. #
  50. # server is started with
  51. # venti/venti
  52. # the name of the index
  53. index main
  54. # the index sections
  55. isect /tmp/disks/isect0
  56. isect /tmp/disks/isect1
  57. # the arenas
  58. arenas /tmp/disks/arenas
  59. .EE
  60. .SH "SEE ALSO"
  61. .IR venti (8),
  62. .IR ventiaux (8)