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.
958{
960 int rc;
964
965 if (!server || (*server == '\0'))
966 {
968 return NULL;
969 }
970
971
977
978 snprintf(file, sizeof(file), "%s%s", strstr(server, "://") ? "" : "news://", server);
980 if (!url || (url->
path && *url->
path) ||
983 {
985 mutt_error(
_(
"%s is an invalid news server specification"), server);
986 return NULL;
987 }
989 {
992 }
994
995
996 const char *
user = NULL;
997 const char *
pass = NULL;
999 {
1002 }
1004 {
1007 }
1008
1009
1011 if (!conn)
1012 return NULL;
1014 {
1017 }
1018
1019
1021
1023
1024
1027 if ((rc >= 0) && c_news_cache_dir)
1028 {
1031 {
1032 mutt_error(
_(
"Can't create %s: %s"), file, strerror(errno));
1033 }
1035 }
1036
1037
1038 if (rc >= 0)
1039 {
1048 }
1049 if (rc >= 0)
1050 {
1051
1053 {
1055 }
1056 else
1057 {
1058
1060 }
1061 }
1062
1063 if (rc >= 0)
1065
1066#ifdef USE_HCACHE
1067
1069 {
1070 struct dirent *de = NULL;
1072
1073 if (dir)
1074 {
1075 while ((de = readdir(dir)))
1076 {
1078 char *group = de->d_name;
1079
1080 char *p = group + strlen(group) - 7;
1082 continue;
1083 *p = '\0';
1086 continue;
1087
1089 if (!hc)
1090 continue;
1091
1092
1094 if (hdata)
1095 {
1098
1100 {
1102 {
1103 mdata->first_message = first;
1104 mdata->last_message = last;
1105 }
1107 {
1108 mdata->last_cached = last;
1110 }
1111 }
1113 }
1115 }
1116 closedir(dir);
1117 }
1118 }
1119#endif
1120
1121 if ((rc < 0) || !leave_lock)
1123
1124 if (rc < 0)
1125 {
1133 return NULL;
1134 }
1135
1137}
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://.