NeoMutt  2025-09-05-55-g97fc89
Teaching an old dog new tricks
DOXYGEN
Loading...
Searching...
No Matches
global.c
Go to the documentation of this file.
1
24
30
31#include "config.h"
32#include <stdbool.h>
33#include <stdio.h>
34#include "mutt/lib.h"
35#include "core/lib.h"
36#include "global.h"
37#include "index/lib.h"
38#include "pager/lib.h"
39#include "curs_lib.h"
40#include "external.h"
41#include "mutt_curses.h"
42#include "mutt_mailbox.h"
43#include "mutt_window.h"
44#include "opcodes.h"
45#include "version.h"
46
56
60static int op_enter_command(int op)
61{
63 window_redraw(NULL);
64 return FR_SUCCESS;
65}
66
70static int op_redraw(int op)
71{
72 clearok(stdscr, true);
75 window_redraw(NULL);
76 return FR_SUCCESS;
77}
78
82static int op_shell_escape(int op)
83{
85 {
86 struct Mailbox *m_cur = get_current_mailbox();
87 if (m_cur)
88 {
89 m_cur->last_checked = 0; // force a check on the next mx_mbox_check() call
91 }
92 }
93 return FR_SUCCESS;
94}
95
99static int op_show_log_messages(int op)
100{
101 struct Buffer *tempfile = buf_pool_get();
102 buf_mktemp(tempfile);
103
104 FILE *fp = mutt_file_fopen(buf_string(tempfile), "a+");
105 if (!fp)
106 {
107 mutt_perror("fopen");
108 buf_pool_release(&tempfile);
109 return FR_ERROR;
110 }
111
112 char buf[32] = { 0 };
113 struct LogLine *ll = NULL;
114 const struct LogLineList lll = log_queue_get();
115 STAILQ_FOREACH(ll, &lll, entries)
116 {
117 mutt_date_localtime_format(buf, sizeof(buf), "%H:%M:%S", ll->time);
118 fprintf(fp, "[%s]<%c> %s", buf, LogLevelAbbr[ll->level + 3], ll->message);
119 if (ll->level <= LL_MESSAGE)
120 fputs("\n", fp);
121 }
122
123 mutt_file_fclose(&fp);
124
125 struct PagerData pdata = { 0 };
126 struct PagerView pview = { &pdata };
127
128 pdata.fname = buf_string(tempfile);
129
130 pview.banner = "messages";
132 pview.mode = PAGER_MODE_OTHER;
133
134 mutt_do_pager(&pview, NULL);
135 buf_pool_release(&tempfile);
136
137 return FR_SUCCESS;
138}
139
143static int op_version(int op)
144{
146 return FR_SUCCESS;
147}
148
152static int op_what_key(int op)
153{
154 mw_what_key();
155 return FR_SUCCESS;
156}
157
158// -----------------------------------------------------------------------------
159
163static const struct GlobalFunction GlobalFunctions[] = {
164 // clang-format off
165 { OP_CHECK_STATS, op_check_stats },
166 { OP_ENTER_COMMAND, op_enter_command },
167 { OP_REDRAW, op_redraw },
168 { OP_SHELL_ESCAPE, op_shell_escape },
169 { OP_SHOW_LOG_MESSAGES, op_show_log_messages },
170 { OP_VERSION, op_version },
171 { OP_WHAT_KEY, op_what_key },
172 { 0, NULL },
173 // clang-format on
174};
175
182{
183 int rc = FR_UNKNOWN;
184 for (size_t i = 0; GlobalFunctions[i].op != OP_NULL; i++)
185 {
186 const struct GlobalFunction *fn = &GlobalFunctions[i];
187 if (fn->op == op)
188 {
189 rc = fn->function(op);
190 break;
191 }
192 }
193
194 if (rc == FR_UNKNOWN) // Not our function
195 return rc;
196
197 const char *result = dispatcher_get_retval_name(rc);
198 mutt_debug(LL_DEBUG1, "Handled %s (%d) -> %s\n", opcodes_get_name(op), op, NONULL(result));
199
200 return FR_SUCCESS; // Whatever the outcome, we handled it
201}
static const char * buf_string(const struct Buffer *buf)
Convert a buffer to a const char * "string".
Definition buffer.h:96
Convenience wrapper for the core headers.
GUI miscellaneous curses (window drawing) routines.
const char * dispatcher_get_retval_name(int rv)
Get the name of a return value.
Definition dispatcher.c:54
@ FR_SUCCESS
Valid function - successfully performed.
Definition dispatcher.h:39
@ FR_UNKNOWN
Unknown function.
Definition dispatcher.h:33
@ FR_ERROR
Valid function - error occurred.
Definition dispatcher.h:38
int mutt_do_pager(struct PagerView *pview, struct Email *e)
Display some page-able text to the user (help or attachment)
Definition do_pager.c:122
void mutt_enter_command(void)
Enter a neomutt command.
Definition external.c:621
bool mutt_shell_escape(void)
Invoke a command in a subshell.
Definition external.c:579
Manage where the email is piped to external commands.
#define mutt_file_fclose(FP)
Definition file.h:139
#define mutt_file_fopen(PATH, MODE)
Definition file.h:138
static const struct GlobalFunction GlobalFunctions[]
All the NeoMutt functions that the Global supports.
Definition global.c:163
Global functions.
int global_function_dispatcher(struct MuttWindow *win, int op)
Perform a Global function - Implements function_dispatcher_t -.
Definition global.c:181
static int op_redraw(struct EnterWindowData *wdata, int op)
Redraw the screen - Implements enter_function_t -.
Definition functions.c:433
static int op_redraw(int op)
Clear and redraw the screen - Implements global_function_t -.
Definition global.c:70
static int op_check_stats(int op)
Calculate message statistics for all mailboxes - Implements global_function_t -.
Definition global.c:50
static int op_enter_command(int op)
Enter a neomuttrc command - Implements global_function_t -.
Definition global.c:60
static int op_shell_escape(int op)
Invoke a command in a subshell - Implements global_function_t -.
Definition global.c:82
static int op_show_log_messages(int op)
Show log (and debug) messages - Implements global_function_t -.
Definition global.c:99
static int op_what_key(int op)
display the keycode for a key press - Implements global_function_t -
Definition global.c:152
static int op_version(int op)
Show the NeoMutt version number - Implements global_function_t -.
Definition global.c:143
void mw_what_key(void)
Display the value of a key -.
Definition curs_lib.c:501
#define mutt_message(...)
Definition logging2.h:92
#define mutt_debug(LEVEL,...)
Definition logging2.h:90
#define mutt_perror(...)
Definition logging2.h:94
GUI manage the main index (list of emails)
struct Mailbox * get_current_mailbox(void)
Get the current Mailbox.
Definition index.c:721
@ LL_MESSAGE
Log informational message.
Definition logging2.h:43
@ LL_DEBUG1
Log at debug level 1.
Definition logging2.h:44
size_t mutt_date_localtime_format(char *buf, size_t buflen, const char *format, time_t t)
Format localtime.
Definition date.c:950
Convenience wrapper for the library headers.
struct LogLineList log_queue_get(void)
Get the Log Queue.
Definition logging.c:362
const char * LogLevelAbbr
Abbreviations of logging level names.
Definition logging.c:46
Define wrapper functions around Curses.
void mutt_resize_screen(void)
Update NeoMutt's opinion about the window size.
Definition resize.c:76
int mutt_mailbox_check(struct Mailbox *m_cur, CheckStatsFlags flags)
Check all all Mailboxes for new mail.
Mailbox helper functions.
void window_redraw(struct MuttWindow *win)
Reflow, recalc and repaint a tree of Windows.
void window_invalidate_all(void)
Mark all windows as in need of repaint.
Window management.
#define MUTT_MAILBOX_CHECK_STATS
Ignore mail_check_stats and calculate statistics (used by <check-stats>)
Definition mxapi.h:52
#define MUTT_MAILBOX_CHECK_POSTPONED
Make sure the number of postponed messages is updated.
Definition mxapi.h:51
const char * opcodes_get_name(int op)
Get the name of an opcode.
Definition opcodes.c:48
All user-callable functions.
GUI display a file/email/help in a viewport with paging.
#define MUTT_PAGER_LOGS
Logview mode.
Definition lib.h:72
#define MUTT_PAGER_BOTTOM
Start at the bottom.
Definition lib.h:73
@ PAGER_MODE_OTHER
Pager is invoked via 3rd path. Non-email content is likely to be shown.
Definition lib.h:140
struct Buffer * buf_pool_get(void)
Get a Buffer from the pool.
Definition pool.c:82
void buf_pool_release(struct Buffer **ptr)
Return a Buffer to the pool.
Definition pool.c:96
#define STAILQ_FOREACH(var, head, field)
Definition queue.h:390
#define NONULL(x)
Definition string2.h:43
String manipulation buffer.
Definition buffer.h:36
A NeoMutt function.
Definition global.h:43
global_function_t function
Function to call.
Definition global.h:45
int op
Op code, e.g. OP_ENTER_COMMAND.
Definition global.h:44
A Log line.
Definition logging2.h:79
char * message
Message to be logged.
Definition logging2.h:85
enum LogLevel level
Log level, e.g. LL_DEBUG1.
Definition logging2.h:84
time_t time
Timestamp of the message.
Definition logging2.h:80
A mailbox.
Definition mailbox.h:79
time_t last_checked
Last time we checked this mailbox for new mail.
Definition mailbox.h:105
Data to be displayed by PagerView.
Definition lib.h:159
const char * fname
Name of the file to read.
Definition lib.h:163
Paged view into some data.
Definition lib.h:170
struct PagerData * pdata
Data that pager displays. NOTNULL.
Definition lib.h:171
enum PagerMode mode
Pager mode.
Definition lib.h:172
PagerFlags flags
Additional settings to tweak pager's function.
Definition lib.h:173
const char * banner
Title to display in status bar.
Definition lib.h:174
#define buf_mktemp(buf)
Definition tmp.h:33
const char * mutt_make_version(void)
Generate the NeoMutt version string.
Definition version.c:295
Display version and copyright about NeoMutt.