-#ifdef __cplusplus
-extern "C" {
-#endif
-
#define LISTING_FOLLOWS 100
#define CIT_OK 200
#define MORE_DATA 300
#define ASYNC_MSG 900
#define ASYNC_GEXP 02
-#define QR_PERMANENT 1 /* Room does not purge */
-#define QR_INUSE 2 /* Set if in use, clear if avail */
-#define QR_PRIVATE 4 /* Set for any type of private room */
-#define QR_PASSWORDED 8 /* Set if there's a password too */
-#define QR_GUESSNAME 16 /* Set if it's a guessname room */
-#define QR_DIRECTORY 32 /* Directory room */
-#define QR_UPLOAD 64 /* Allowed to upload */
-#define QR_DOWNLOAD 128 /* Allowed to download */
-#define QR_VISDIR 256 /* Visible directory */
-#define QR_ANONONLY 512 /* Anonymous-Only room */
-#define QR_ANONOPT 1024 /* Anonymous-Option room */
-#define QR_NETWORK 2048 /* (no longer used) */
-#define QR_PREFONLY 4096 /* Preferred status needed to enter */
-#define QR_READONLY 8192 /* Aide status required to post */
-#define QR_MAILBOX 16384 /* Set if this is a private mailbox */
+#define QR_PERMANENT 1 // Room does not purge
+#define QR_INUSE 2 // Set if in use, clear if avail
+#define QR_PRIVATE 4 // Set for any type of private room
+#define QR_PASSWORDED 8 // Set if there's a password too
+#define QR_GUESSNAME 16 // Set if it's a guessname room
+#define QR_DIRECTORY 32 // Directory room
+#define QR_UPLOAD 64 // Allowed to upload
+#define QR_DOWNLOAD 128 // Allowed to download
+#define QR_VISDIR 256 // Visible directory
+#define QR_ANONONLY 512 // Anonymous-Only room
+#define QR_ANONOPT 1024 // Anonymous-Option room
+#define QR_NETWORK 2048 // (no longer used)
+#define QR_PREFONLY 4096 // Preferred status needed to enter
+#define QR_READONLY 8192 // Aide status required to post
+#define QR_MAILBOX 16384 // Set if this is a private mailbox
-#define QR2_SYSTEM 1 /* System room; hide by default */
-#define QR2_SELFLIST 2 /* Self-service mailing list mgmt */
-#define QR2_COLLABDEL 4 /* Anyone who can post can delete */
-#define QR2_SUBJECTREQ 8 /* Subject strongly recommended */
-#define QR2_SMTP_PUBLIC 16 /* Listservice Subscribers may post */
+#define QR2_SYSTEM 1 // System room; hide by default
+#define QR2_SELFLIST 2 // Self-service mailing list mgmt
+#define QR2_COLLABDEL 4 // Anyone who can post can delete
+#define QR2_SUBJECTREQ 8 // Subject strongly recommended
+#define QR2_SMTP_PUBLIC 16 // Listservice Subscribers may post
-#define US_NEEDVALID 1 /* User needs to be validated */
-#define US_EXTEDIT 2 /* Always use external editor */
-#define US_PERM 4 /* Permanent user */
-#define US_LASTOLD 16 /* Print last old message with new */
-#define US_EXPERT 32 /* Experienced user */
-#define US_UNLISTED 64 /* Unlisted userlog entry */
-#define US_NOPROMPT 128 /* Don't prompt after each message */
-#define US_PROMPTCTL 256 /* <N>ext & <S>top work at prompt */
-#define US_DISAPPEAR 512 /* Use "disappearing msg prompts" */
-#define US_REGIS 1024 /* Registered user */
-#define US_PAGINATOR 2048 /* Pause after each screen of text */
-#define US_INTERNET 4096 /* Internet mail privileges */
-#define US_FLOORS 8192 /* User wants to see floors */
-#define US_COLOR 16384 /* User wants ANSI color support */
+#define US_NEEDVALID 1 // User needs to be validated
+#define US_EXTEDIT 2 // Always use external editor
+#define US_PERM 4 // Permanent user
+#define US_LASTOLD 16 // Print last old message with new
+#define US_EXPERT 32 // Experienced user
+#define US_UNLISTED 64 // Unlisted userlog entry
+#define US_NOPROMPT 128 // Don't prompt after each message
+#define US_PROMPTCTL 256 // <N>ext & <S>top work at prompt
+#define US_DISAPPEAR 512 // Use "disappearing msg prompts"
+#define US_REGIS 1024 // Registered user
+#define US_PAGINATOR 2048 // Pause after each screen of text
+#define US_INTERNET 4096 // Internet mail privileges
+#define US_FLOORS 8192 // User wants to see floors
+#define US_COLOR 16384 // User wants ANSI color support
#define US_USER_SET (US_LASTOLD | US_EXPERT | US_UNLISTED | \
US_NOPROMPT | US_DISAPPEAR | US_PAGINATOR | \
US_FLOORS | US_COLOR | US_PROMPTCTL | US_EXTEDIT)
-#define UA_KNOWN 2 /* Room appears in a 'known rooms' list */
-#define UA_GOTOALLOWED 4 /* User may goto this room if specified by exact name */
-#define UA_HASNEWMSGS 8 /* Unread messages exist in this room */
-#define UA_ZAPPED 16 /* User has forgotten (zapped) this room */
-#define UA_POSTALLOWED 32 /* User may post top-level messages here */
-#define UA_ADMINALLOWED 64 /* Aide or Room Aide rights exist here */
-#define UA_DELETEALLOWED 128 /* User is allowed to delete messages from this room */
-#define UA_REPLYALLOWED 256 /* User is allowed to reply to existing messages here */
-
-#ifdef __cplusplus
-}
-#endif
+#define UA_KNOWN 2 // Room appears in a 'known rooms' list
+#define UA_GOTOALLOWED 4 // User may goto this room if specified by exact name
+#define UA_HASNEWMSGS 8 // Unread messages exist in this room
+#define UA_ZAPPED 16 // User has forgotten (zapped) this room
+#define UA_POSTALLOWED 32 // User may post top-level messages here
+#define UA_ADMINALLOWED 64 // Aide or Room Aide rights exist here
+#define UA_DELETEALLOWED 128 // User is allowed to delete messages from this room
+#define UA_REPLYALLOWED 256 // User is allowed to reply to existing messages here
MSG_HDRS_THREADS = 9
};
-/*
- * Possible return codes from CtdlOutputMsg()
- */
+// Possible return codes from CtdlOutputMsg()
enum {
om_ok,
om_not_logged_in,
om_access_denied
};
-/*
- * Values of "headers_only" when calling message output routines
- */
-#define HEADERS_ALL 0 /* Headers and body */
-#define HEADERS_ONLY 1 /* Headers only */
-#define HEADERS_NONE 2 /* Body only */
-#define HEADERS_FAST 3 /* Headers only with no MIME info */
+// Values of "headers_only" when calling message output routines
+#define HEADERS_ALL 0 // Headers and body
+#define HEADERS_ONLY 1 // Headers only
+#define HEADERS_NONE 2 // Body only
+#define HEADERS_FAST 3 // Headers only with no MIME info
struct ma_info {
- int is_ma; /* Set to 1 if we are using this stuff */
- int freeze; /* Freeze the replacement chain because we're
- * digging through a subsection */
- int did_print; /* One alternative has been displayed */
- char chosen_part[128]; /* Which part of a m/a did we choose? */
- int chosen_pref; /* Chosen part preference level (lower is better) */
- int use_fo_hooks; /* Use fixed output hooks */
- int dont_decode; /* should we call the decoder or not? */
+ int is_ma; // Set to 1 if we are using this stuff
+ int freeze; // Freeze the replacement chain because we're digging through a subsection
+ int did_print; // One alternative has been displayed
+ char chosen_part[128]; // Which part of a m/a did we choose?
+ int chosen_pref; // Chosen part preference level (lower is better)
+ int use_fo_hooks; // Use fixed output hooks
+ int dont_decode; // should we call the decoder or not?
};
-struct repl { /* Info for replication checking */
+struct repl { // Info for replication checking
char exclusive_id[SIZ];
time_t highest;
};
-/*
- * This is a list of "harvested" email addresses that we might want to
- * stick into someone's address book. But we defer this operaiton so
- * it can be done asynchronously.
- */
+// This is a list of "harvested" email addresses that we might want to
+// stick into someone's address book. But we defer this operaiton so
+// it can be done asynchronously.
struct addresses_to_be_filed {
struct addresses_to_be_filed *next;
char *roomname;
ForEachMsgCallback CallBack,
void *userdata);
int CtdlDeleteMessages(const char *, long *, int, char *);
-long CtdlWriteObject(char *req_room, /* Room to stuff it in */
- char *content_type, /* MIME type of this object */
- char *raw_message, /* Data to be written */
- off_t raw_length, /* Size of raw_message */
- struct ctdluser *is_mailbox, /* Mailbox room? */
- int is_binary, /* Is encoding necessary? */
- unsigned int flags /* Internal save flags */
+long CtdlWriteObject(char *req_room, // Room to stuff it in
+ char *content_type, // MIME type of this object
+ char *raw_message, // Data to be written
+ off_t raw_length, // Size of raw_message
+ struct ctdluser *is_mailbox, // Mailbox room?
+ int is_binary, // Is encoding necessary?
+ unsigned int flags // Internal save flags
);
struct CtdlMessage *CtdlFetchMessage(long msgnum, int with_body);
struct CtdlMessage * CM_Duplicate
long CtdlSaveThisMessage(struct CtdlMessage *msg, long msgid, int Reply);
char *CtdlReadMessageBody(char *terminator, long tlen, size_t maxlen, StrBuf *exist, int crlf);
StrBuf *CtdlReadMessageBodyBuf(
- char *terminator, /* token signalling EOT */
+ char *terminator, // token signalling EOT
long tlen,
- size_t maxlen, /* maximum message length */
- StrBuf *exist, /* if non-null, append to it; exist is ALWAYS freed */
- int crlf /* CRLF newlines instead of LF */
+ size_t maxlen, // maximum message length
+ StrBuf *exist, // if non-null, append to it; exist is ALWAYS freed
+ int crlf // CRLF newlines instead of LF
);
-int CtdlOutputMsg(long msg_num, /* message number (local) to fetch */
- int mode, /* how would you like that message? */
- int headers_only, /* eschew the message body? */
- int do_proto, /* do Citadel protocol responses? */
- int crlf, /* 0=LF, 1=CRLF */
- char *section, /* output a message/rfc822 section */
- int flags, /* should the bessage be exported clean? */
- char **Author, /* if you want to know the author of the message... */
- char **Address, /* if you want to know the sender address of the message... */
- char **MessageID /* if you want to know the Message-ID of the message... */
+int CtdlOutputMsg(long msg_num, // message number (local) to fetch
+ int mode, // how would you like that message?
+ int headers_only, // eschew the message body?
+ int do_proto, // do Citadel protocol responses?
+ int crlf, // 0=LF, 1=CRLF
+ char *section, // output a message/rfc822 section
+ int flags, // should the bessage be exported clean?
+ char **Author, // if you want to know the author of the message...
+ char **Address, // if you want to know the sender address of the message...
+ char **MessageID // if you want to know the Message-ID of the message...
);
-/* Flags which may be passed to CtdlOutputMsg() and CtdlOutputPreLoadedMsg() */
-#define QP_EADDR (1<<0) /* quoted-printable encode email addresses */
+// Flags which may be passed to CtdlOutputMsg() and CtdlOutputPreLoadedMsg()
+#define QP_EADDR (1<<0) // quoted-printable encode email addresses
#define CRLF (1<<1)
-#define ESC_DOT (1<<2) /* output a line containing only "." as ".." instead */
-#define SUPPRESS_ENV_TO (1<<3) /* suppress Envelope-to: header (warning: destructive!) */
+#define ESC_DOT (1<<2) // output a line containing only "." as ".." instead
+#define SUPPRESS_ENV_TO (1<<3) // suppress Envelope-to: header (warning: destructive!)
int CtdlOutputPreLoadedMsg(struct CtdlMessage *,
- int mode, /* how would you like that message? */
- int headers_only, /* eschew the message body? */
- int do_proto, /* do Citadel protocol responses? */
- int crlf, /* 0=LF, 1=CRLF */
- int flags /* should the bessage be exported clean? */
+ int mode, // how would you like that message?
+ int headers_only, // eschew the message body?
+ int do_proto, // do Citadel protocol responses?
+ int crlf, // 0=LF, 1=CRLF
+ int flags // should the bessage be exported clean?
);
-/* values for which_set */
+// values for which_set
enum {
ctdlsetseen_seen,
ctdlsetseen_answered
struct CtdlMessage *CtdlMakeMessage(
- struct ctdluser *author, /* author's user structure */
- char *recipient, /* NULL if it's not mail */
- char *recp_cc, /* NULL if it's not mail */
- char *room, /* room where it's going */
- int type, /* see MES_ types in header file */
- int format_type, /* variformat, plain text, MIME... */
- char *fake_name, /* who we're masquerading as */
- char *my_email, /* which of my email addresses to use (empty is ok) */
- char *subject, /* Subject (optional) */
- char *supplied_euid, /* ...or NULL if this is irrelevant */
- char *preformatted_text, /* ...or NULL to read text from client */
- char *references /* Thread references */
+ struct ctdluser *author, // author's user structure
+ char *recipient, // NULL if it's not mail
+ char *recp_cc, // NULL if it's not mail
+ char *room, // room where it's going
+ int type, // see MES_ types in header file
+ int format_type, // variformat, plain text, MIME...
+ char *fake_name, // who we're masquerading as
+ char *my_email, // which of my email addresses to use (empty is ok)
+ char *subject, // Subject (optional)
+ char *supplied_euid, // ...or NULL if this is irrelevant
+ char *preformatted_text, // ...or NULL to read text from client
+ char *references // Thread references
);
struct CtdlMessage *CtdlMakeMessageLen(
- struct ctdluser *author, /* author's user structure */
- char *recipient, /* NULL if it's not mail */
+ struct ctdluser *author, // author's user structure
+ char *recipient, // NULL if it's not mail
long rcplen,
- char *recp_cc, /* NULL if it's not mail */
+ char *recp_cc, // NULL if it's not mail
long cclen,
- char *room, /* room where it's going */
+ char *room, // room where it's going
long roomlen,
- int type, /* see MES_ types in header file */
- int format_type, /* variformat, plain text, MIME... */
- char *fake_name, /* who we're masquerading as */
+ int type, // see MES_ types in header file
+ int format_type, // variformat, plain text, MIME...
+ char *fake_name, // who we're masquerading as
long fnlen,
- char *my_email, /* which of my email addresses to use (empty is ok) */
+ char *my_email, // which of my email addresses to use (empty is ok)
long myelen,
- char *subject, /* Subject (optional) */
+ char *subject, // Subject (optional)
long subjlen,
- char *supplied_euid, /* ...or NULL if this is irrelevant */
+ char *supplied_euid, // ...or NULL if this is irrelevant
long euidlen,
- char *preformatted_text, /* ...or NULL to read text from client */
+ char *preformatted_text, // ...or NULL to read text from client
long textlen,
- char *references, /* Thread references */
+ char *references, // Thread references
long reflen
);
void AdjRefCountList(long *msgnum, long nmsg, int incr);
-#endif /* MSGBASE_H */
+#endif