You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

33 lines
1.7 KiB

  1. # Terminology
  2. * `disk`, `drive`, `disk drive`: A [physical data storage
  3. device](https://en.wikipedia.org/wiki/Disk_storage). Such as a hard
  4. drive or solid-state drive. Usually requires the use of a filesystem
  5. to be useful. mergerfs does not deal with disks.
  6. * `filesystem`: Lowlevel software which provides a way to organize data
  7. and provide access to said data in a standard way. A filesystem is a
  8. higher level abstraction that may or may not be stored on a
  9. disk. mergerfs deals exclusively with filesystems.
  10. * `path`: A location within a filesystem. mergerfs can work with any
  11. path within a filesystem and not simply the root.
  12. * `branch`: A base path used in a mergerfs pool. mergerfs can
  13. accomidate multiple paths pointing to the same filesystem.
  14. * `pool`: The mergerfs mount. The union of the branches. The instance
  15. of mergerfs. You can mount multiple mergerfs pools. Even with the
  16. same branches.
  17. * `relative path`: The path in the pool relative to the branch and
  18. mount. `foo/bar` is the relative path of mergerfs mount
  19. `/mnt/mergerfs/foo/bar`.
  20. * `function`: A filesystem call such as `open`, `unlink`, `create`,
  21. `getattr`, `rmdir`, etc. The requests your software make to the
  22. filesystem.
  23. * `category`: A collection of functions based on basic behavior
  24. (action, create, search).
  25. * `policy`: The algorithm used to select a file or files when
  26. performing a function.
  27. * `path preservation`: Aspect of some policies which includes checking
  28. the path for which a file would be created.
  29. * `out-of-band`:
  30. [out-of-band](https://en.wikipedia.org/wiki/Out-of-band) in our
  31. context refers to interacting with the underlying filesystem
  32. directly instead of going through mergerfs (or NFS or Samba).