subrelay/include/ilib/misc.h

/*
 * this is free software: you can redistribute it and/or modify it
 * under the terms of the GNU General Public License as published
 * by the Free Software Foundation, either version 2 of the License, or
 * (at your option) any later version.
 *
 * this is distributed in the hope that it will be useful, but
 * WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.
 * See the GNU General Public License for more details.
 *
 * You should have received a copy of the GNU General Public License
 * along with this program.  If not, see <http://www.gnu.org/licenses/>.";
 *
 * (c) Alexander Vdolainen 2007, 2026 <alex@vapaa.xyz>
 * subrelay: a minimalistic maillist server based on external IMAPs/SMTPs
 *
 * misc.h: misc definitions and functions
 *
 */
#ifndef __MISC_H__
#define __MISC_H__

/* Some various constants used across the project */
#define PATHLEN_MAX  2048

/* Build time constants */
#define PENDING_ID_LEN       16
#define DEFAULT_PENDING_TTL  86400 /* default TTL for confirmation email */
#define EMAILLEN_MAX         256   /* Max length of the email address */
#define TAGLEN_MAX           512   /* Max length of the tag subject in broadcast email */

/* message builder -- a safe growing buffer for message rebuilds */
typedef struct {
  char *data;
  size_t len;
  size_t cap;
} message_builder_t;

/* MB functions */
int mb_reserve(message_builder_t *b, size_t additional);
int mb_append(message_builder_t *b, const void *data, size_t len);
int mb_append_cstr(message_builder_t *b, const char *s);

/* helper functions */
/* Trims whitespace and trailing \r\n */
char *strtrim_whitespace(char *str);

#endif /* __MISC_H__ */