citadel/docs/netconfigs.txt

   1
   2 Description of "netconfigs" records
   3
   4 These files contain a set of network configurations for a room.  They are
   5 stored in the directory $CTDLDIR/netconfigs and are named according to each
   6 room's internal ID number.  When a room is deleted, its network configuration
   7 file is deleted as well.
   8
   9 The configuration file contains one or more lines of text, each line
  10 containing a configuration option.  These lines may specify message pointers,
  11 room sharing instructions, mailing list recipients, etc.  Fields are separated
  12 by the vertical bar character ("|") and there will always be at least one
  13 field on each line.
  14
  15
  16 INSTRUCTION:  lastsent
  17 SYNTAX:       lastsent|0000000
  18 DESCRIPTION:
  19 Defines the *local* message number of the last message in this room which
  20 we have performed outbound network processing on.  Any batch job which sends
  21 out messages should do stuff.
  22
  23
  24 INSTRUCTION:  listrecp
  25 SYNTAX:       listrecp|friko@mumjiboolean.com
  26 DESCRIPTION:
  27 Defines a recipient to whom all messages in this room should be sent.  This
  28 is used for "list serve" applications.
  29
  30
  31 INSTRUCTION:  digestrecp
  32 SYNTAX:       digestrecp|friko@mumjiboolean.com
  33 DESCRIPTION:
  34 As of 2021, this is now an alias for listrecp and may be converted to listrecp
  35 by the mailing list manager.
  36
  37
  38 INSTRUCTION:  participate
  39 SYNTAX:       participate|list-addr@example.com
  40 This allows a room to be a  *subscriber* to an external mailing list
  41 somewhere.  The room's email address should be subscribed to the list, and the
  42 external listserv should be told "do not send me my own messages."  Any
  43 messages which originated on Citadel (as opposed to messages which arrived via
  44 email, such as those from the list) will be sent to the list, with the display
  45 name of the author kept intact, but the email address changed to the address of
  46 the room.
  47
  48 This is somewhat finicky, which is why it is not officially supported, and
  49 why there are no facilities in the user interface to configure it.  If you want
  50 to use this option you are on your own.
  51
  52
  53 INSTRUCTION:  pop3client
  54 SYNTAX:       pop3client|hostname|username|password|keep|interval
  55 Periodically fetch messages from a remote POP3 account and store them in this
  56 room.  Messages will be deleted from the remote account once successfully stored.
  57 if Keep is set, messages won't be erased on the remote host.
  58 Interval can specify a bigger value than the system configs value.
  59
  60
  61 INSTRUCTION:    rssclient
  62 SYNTAX:         rssclient|url
  63 Periodically scrape an external RSS or Atom feed and store new items in this
  64 room.  We try to positively identify unique messages and avoid storing them
  65 multiple times.