Open a connection to an NNTP server.
Automatically loads a newsrc into memory, if necessary. Checks the size/mtime of a newsrc file, if it doesn't match, load again. Hmm, if a system has broken mtimes, this might mean the file is reloaded every time, which we'd have to fix.
954{
956 int rc;
960
961 if (!server || (*server == '\0'))
962 {
964 return NULL;
965 }
966
967
973
974 snprintf(file, sizeof(file), "%s%s", strstr(server, "://") ? "" : "news://", server);
976 if (!url || (url->
path && *url->
path) ||
979 {
981 mutt_error(
_(
"%s is an invalid news server specification"), server);
982 return NULL;
983 }
985 {
988 }
990
991
992 const char *
user = NULL;
993 const char *
pass = NULL;
995 {
998 }
1000 {
1003 }
1004
1005
1007 if (!conn)
1008 return NULL;
1010 {
1013 }
1014
1015
1017
1019
1020
1023 if ((rc >= 0) && c_news_cache_dir)
1024 {
1027 {
1028 mutt_error(
_(
"Can't create %s: %s"), file, strerror(errno));
1029 }
1031 }
1032
1033
1034 if (rc >= 0)
1035 {
1044 }
1045 if (rc >= 0)
1046 {
1047
1049 {
1051 }
1052 else
1053 {
1054
1056 }
1057 }
1058
1059 if (rc >= 0)
1061
1062#ifdef USE_HCACHE
1063
1065 {
1066 struct dirent *de = NULL;
1068
1069 if (dir)
1070 {
1071 while ((de = readdir(dir)))
1072 {
1074 char *group = de->d_name;
1075
1076 char *p = group + strlen(group) - 7;
1078 continue;
1079 *p = '\0';
1082 continue;
1083
1085 if (!hc)
1086 continue;
1087
1088
1090 if (hdata)
1091 {
1092 anum_t first = 0, last = 0;
1093
1095 {
1097 {
1098 mdata->first_message = first;
1099 mdata->last_message = last;
1100 }
1102 {
1103 mdata->last_cached = last;
1105 }
1106 }
1108 }
1110 }
1111 closedir(dir);
1112 }
1113 }
1114#endif
1115
1116 if ((rc < 0) || !leave_lock)
1118
1119 if (rc < 0)
1120 {
1128 return NULL;
1129 }
1130
1132}
char * buf_strdup(const struct Buffer *buf)
Copy a Buffer's string.
const char * cs_subset_path(const struct ConfigSubset *sub, const char *name)
Get a path config item by name.
const struct Expando * cs_subset_expando(const struct ConfigSubset *sub, const char *name)
Get an Expando config item by name.
@ MUTT_ACCT_SSL
Account uses SSL/TLS.
@ MUTT_ACCT_PASS
Password field has been set.
@ MUTT_ACCT_USER
User field has been set.
int expando_filter(const struct Expando *exp, const struct ExpandoRenderCallback *erc, void *data, MuttFormatFlags flags, int max_cols, char **env_list, struct Buffer *buf)
Render an Expando and run the result through a filter.
const struct ExpandoRenderCallback NntpRenderCallbacks[]
Callbacks for Newsrc Expandos.
int mutt_file_mkdir(const char *path, mode_t mode)
Recursively create directories.
DIR * mutt_file_opendir(const char *path, enum MuttOpenDirMode mode)
Open a directory.
@ MUTT_OPENDIR_NONE
Plain opendir()
static const char * nntp_get_field(enum ConnAccountField field, void *gf_data)
Get connection login credentials - Implements ConnAccount::get_field() -.
#define mutt_debug(LEVEL,...)
void * mutt_hash_find(const struct HashTable *table, const char *strkey)
Find the HashElem data in a Hash Table element using a key.
void mutt_hash_free(struct HashTable **ptr)
Free a hash table.
void hcache_close(struct HeaderCache **ptr)
Multiplexor for StoreOps::close.
char * hcache_fetch_raw_str(struct HeaderCache *hc, const char *key, size_t keylen)
Fetch a string from the cache.
@ LL_DEBUG2
Log at debug level 2.
#define FREE(x)
Free memory and set the pointer to NULL.
bool mutt_str_equal(const char *a, const char *b)
Compare two strings.
size_t mutt_str_copy(char *dest, const char *src, size_t dsize)
Copy a string into a buffer (guaranteeing NUL-termination)
int account_from_url(struct ConnAccount *cac, const struct Url *url)
Fill ConnAccount with information from url.
@ MUTT_ACCT_TYPE_NNTP
Nntp (Usenet) Account.
struct Connection * mutt_conn_find(const struct ConnAccount *cac)
Find a connection from a list.
void expand_path(struct Buffer *buf, bool regex)
Create the canonical path.
struct HeaderCache * nntp_hcache_open(struct NntpMboxData *mdata)
Open newsgroup hcache.
void nntp_clear_cache(struct NntpAccountData *adata)
Clear the NNTP cache.
int nntp_newsrc_parse(struct NntpAccountData *adata)
Parse .newsrc file.
void nntp_newsrc_close(struct NntpAccountData *adata)
Unlock and close .newsrc file.
static int active_get_cache(struct NntpAccountData *adata)
Load list of all newsgroups from cache.
static void cache_expand(char *dst, size_t dstlen, struct ConnAccount *cac, const char *src)
Make fully qualified cache file name.
struct NntpAccountData * nntp_adata_new(struct Connection *conn)
Allocate and initialise a new NntpAccountData structure.
int nntp_active_fetch(struct NntpAccountData *adata, bool mark_new)
Fetch list of all newsgroups from server.
int nntp_check_new_groups(struct Mailbox *m, struct NntpAccountData *adata)
Check for new groups/articles in subscribed groups.
int nntp_open_connection(struct NntpAccountData *adata)
Connect to server, authenticate and get capabilities.
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
@ MUTT_FORMAT_NONE
No flags are set.
int mutt_socket_close(struct Connection *conn)
Close a socket.
void * adata
Private data (for Mailbox backends)
String manipulation buffer.
size_t dsize
Length of data.
Login details for a remote server.
const char * service
Name of the service, e.g. "imap".
const char *(* get_field)(enum ConnAccountField field, void *gf_data)
unsigned char type
Connection type, e.g. MUTT_ACCT_TYPE_IMAP.
MuttAccountFlags flags
Which fields are initialised, e.g. MUTT_ACCT_USER.
unsigned short port
Port to connect to.
struct ConnAccount account
Account details: username, password, etc.
void * mdata
Driver specific data.
Container for Accounts, Notifications.
char ** env
Private copy of the environment variables.
struct ConfigSubset * sub
Inherited config items.
NNTP-specific Account data -.
struct HashTable * groups_hash
Hash Table: "newsgroup" -> NntpMboxData.
struct NntpMboxData ** groups_list
List of newsgroups.
char * authenticators
Authenticators list.
bool cacheable
Can be cached.
char * newsrc_file
Newsrc file path.
NNTP-specific Mailbox data -.
anum_t last_message
Last article number.
char * group
Name of newsgroup.
struct NntpAccountData * adata
Account data.
A parsed URL proto://user:password@host:port/path?a=1&b=2
enum UrlScheme scheme
Scheme, e.g. U_SMTPS.
struct Url * url_parse(const char *src)
Fill in Url.
void url_free(struct Url **ptr)
Free the contents of a URL.
@ U_NNTPS
Url is nntps://.