NeoMutt  2025-12-11-435-g4ac674
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
lib.h File Reference

Compressed mbox local mailbox type. More...

#include <stdbool.h>
#include <stdio.h>
+ Include dependency graph for lib.h:
+ This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures

struct  CompressInfo
 Private data for compress. More...
 

Enumerations

enum  ExpandoDataCompress { ED_CMP_FROM = 1 , ED_CMP_TO }
 Expando UIDs for Compression. More...
 

Functions

bool mutt_comp_can_append (struct Mailbox *m)
 Can we append to this path?
 
bool mutt_comp_can_read (const char *path)
 Can we read from this file?
 
int mutt_comp_valid_command (const char *cmd)
 Is this command string allowed?
 

Variables

const struct MxOps MxCompOps
 Compressed Mailbox - Implements MxOps -.
 

Detailed Description

Compressed mbox local mailbox type.

Authors
  • Richard Russon
  • Tóth János

This program 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/.

Definition in file lib.h.

Enumeration Type Documentation

◆ ExpandoDataCompress

Expando UIDs for Compression.

See also
ED_COMPRESS, ExpandoDomain
Enumerator
ED_CMP_FROM 

'from' path

ED_CMP_TO 

'to' path

Definition at line 49 of file lib.h.

50{
51 ED_CMP_FROM = 1,
52 ED_CMP_TO,
53};
@ ED_CMP_FROM
'from' path
Definition lib.h:51
@ ED_CMP_TO
'to' path
Definition lib.h:52

Function Documentation

◆ mutt_comp_can_append()

bool mutt_comp_can_append ( struct Mailbox * m)

Can we append to this path?

Parameters
mMailbox
Return values
trueYes, we can append to the file
falseNo, appending isn't possible

To append to a file we can either use an 'append-hook' or a combination of 'open-hook' and 'close-hook'.

A match means it's our responsibility to append to the file.

Definition at line 334 of file compress.c.

335{
336 if (!m)
337 return false;
338
339 /* If this succeeds, we know there's an open-hook */
340 struct CompressInfo *ci = set_compress_info(m);
341 if (!ci)
342 return false;
343
344 /* We have an open-hook, so to append we need an append-hook,
345 * or a close-hook. */
346 if (ci->cmd_append || ci->cmd_close)
347 return true;
348
349 mutt_error(_("Can't append without an append-hook or close-hook : %s"), mailbox_path(m));
350 return false;
351}
static struct CompressInfo * set_compress_info(struct Mailbox *m)
Find the compress hooks for a mailbox.
Definition compress.c:235
static const char * mailbox_path(const struct Mailbox *m)
Get the Mailbox's path string.
Definition mailbox.h:213
#define mutt_error(...)
Definition logging2.h:94
#define _(a)
Definition message.h:28
Private data for compress.
Definition lib.h:61
struct Expando * cmd_append
append-hook command
Definition lib.h:62
struct Expando * cmd_close
close-hook command
Definition lib.h:63
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_comp_can_read()

bool mutt_comp_can_read ( const char * path)

Can we read from this file?

Parameters
pathPathname of file to be tested
Return values
trueYes, we can read the file
falseNo, we can't read the file

Search for an 'open-hook' with a regex that matches the path.

A match means it's our responsibility to open the file.

Definition at line 363 of file compress.c.

364{
365 if (!path)
366 return false;
367
368 if (mutt_find_hook(CMD_OPEN_HOOK, path))
369 return true;
370
371 return false;
372}
@ CMD_OPEN_HOOK
:open-hook
Definition command.h:100
char * mutt_find_hook(enum CommandId id, const char *pat)
Find a matching hook.
Definition exec.c:114
+ Here is the call graph for this function:
+ Here is the caller graph for this function:

◆ mutt_comp_valid_command()

int mutt_comp_valid_command ( const char * cmd)

Is this command string allowed?

Parameters
cmdCommand string
Return values
1Valid command
0"%f" and/or "%t" is missing

A valid command string must have both "%f" (from file) and "%t" (to file). We don't check if we can actually run the command.

Definition at line 383 of file compress.c.

384{
385 if (!cmd)
386 return 0;
387
388 return strstr(cmd, "%f") && strstr(cmd, "%t");
389}
+ Here is the caller graph for this function: