home *** CD-ROM | disk | FTP | other *** search
/ ARM Club 3 / TheARMClub_PDCD3.iso / hensa / internet / fidomail_1 / !FidoMail / Dox / Domains < prev    next >
Text File  |  1994-01-30  |  3KB  |  81 lines
  1. Domains / complete customisation
  2. --------------------------------
  3.  
  4. It is now possible to have 1 copy of FidoMail, yet run it with completely
  5. different configurations. This can be used for many purposes, one is to have
  6. separate messagebases for different domains. It would also be possible to run
  7. several nodes with one FidoMail.
  8.  
  9. The different domains are defined as follows:
  10.  
  11. There is a directory called <FM$Domains$Dir>. Inside this is a directory for
  12. each domain. Inside each of these are those files and dirs that are _different_
  13. for that particular domain.
  14. In the default setup, this is placed like this:
  15.  
  16. Item                    Usage
  17. -----------------------------------------------------------------------------
  18. Config                    Directory with main config files
  19. Config.!Limits                Limits for all domains
  20. Config.!SetVars                Obey-file to set variables for all
  21.                     domains
  22. Config.Main                Main configuration for all domains
  23. Domains                    General domain-directory
  24. Domains.FidoNet                One domain
  25. Domains.FidoNet.!Activate        Obey-file to activate this domain
  26. Domains.FidoNet.DomainCfg        Domain configuration differences
  27. Domains.FidoNet.FileLists        FileLists in this domain
  28. Domains.FidoNet.Misc.!AddrBook        Address book in this domain
  29. Domains.FidoNet.Misc.AreaMap        Areamap for this domain
  30. Domains.FidoNet.Misc.Forward        How Forwards look in this domain
  31. Domains.FidoNet.Misc.GroupSplit        How Groups are split in this domain
  32. Domains.FidoNet.Misc.OrigAreas        File to detect area changes in this
  33.                     domain
  34. Domains.FidoNet.Msgs            Message base for this domain
  35.  
  36. To make a new domain, READ THIS FILE, and make a new directory in 'Domains',
  37. like the 'FidoNet' one already in there.
  38.  
  39. How domain-selection works
  40. --------------------------
  41.  
  42. When FidoMail starts up, it will scan the 'Domains' directory. The contents of
  43. that will be listed in the 'Misc ⇨ Domain ⇨ ...' submenu.
  44. When you select a domain in that menu, this is what happens:
  45.  
  46. 1. FidoMail will execute the !Activate file for the selected domain.
  47. 2. The !Activate file will set up FM$Domain and FM$PostFix and then run the
  48.    !SetVars file.
  49. 3. The !SetVars file will set up all the other variables according to FM$Domain
  50.    and FM$PostFix, pointing most of them into the domain directory.
  51. 4. FidoMail then restarts itself, using the newly set variables, and hence
  52.    using the files in the selected domain-directory.
  53.  
  54. The domain used at startup (not restart) is activated in exactly the same way,
  55. by the !Run file.
  56.  
  57.  
  58. Configuration
  59. -------------
  60.  
  61. The configuration works in a slightly different way than this. FidoMail will
  62. _always_ take <FM$Config$File> as the configuration, and this is normally
  63. 'Config.Main'.
  64. But in that config file, there is this line:
  65. Include <FM$CurDomain$Dir>.DomainCfg
  66.  
  67. So when FM$CurDomain$Dir is changed (by !SetVars), part of the configuration
  68. will change too, according to the DomainCfg file for that particular domain.
  69. This 'DomainCfg' file then contains what settings you want to be different for
  70. that domain, and that can be everything, if desired.
  71.  
  72. In short: 'Main' contains the things you want in all the domains.
  73.           'DomainCfg' contains the domain-specific additions to this.
  74.  
  75. -----------------------------------------------------------------------------
  76.  
  77. This can all be changed to suit different requirements, by changing the
  78. appropriate obey-files etc.
  79.  
  80.                                   
  81.