1999-10-29 12:10:10 +00:00
|
|
|
/*
|
|
|
|
* BIRD Internet Routing Daemon -- Command-Line Interface
|
|
|
|
*
|
2000-01-19 12:30:19 +00:00
|
|
|
* (c) 1999--2000 Martin Mares <mj@ucw.cz>
|
1999-10-29 12:10:10 +00:00
|
|
|
*
|
|
|
|
* Can be freely distributed and used under the terms of the GNU GPL.
|
|
|
|
*/
|
|
|
|
|
|
|
|
#ifndef _BIRD_CLI_H_
|
|
|
|
#define _BIRD_CLI_H_
|
|
|
|
|
|
|
|
#include "lib/resource.h"
|
2023-04-21 13:26:06 +00:00
|
|
|
#include "lib/lists.h"
|
1999-10-29 12:10:10 +00:00
|
|
|
#include "lib/event.h"
|
2024-06-24 09:09:46 +00:00
|
|
|
#include "lib/tlists.h"
|
|
|
|
#include "conf/conf.h"
|
1999-10-29 12:10:10 +00:00
|
|
|
|
|
|
|
#define CLI_RX_BUF_SIZE 4096
|
|
|
|
#define CLI_TX_BUF_SIZE 4096
|
1999-12-06 12:34:45 +00:00
|
|
|
#define CLI_MAX_ASYNC_QUEUE 4096
|
1999-10-29 12:10:10 +00:00
|
|
|
|
2011-07-03 17:43:30 +00:00
|
|
|
#define CLI_MSG_SIZE 500
|
|
|
|
#define CLI_LINE_SIZE 512
|
|
|
|
|
1999-10-29 12:10:10 +00:00
|
|
|
struct cli_out {
|
|
|
|
struct cli_out *next;
|
|
|
|
byte *wpos, *outpos, *end;
|
|
|
|
byte buf[0];
|
|
|
|
};
|
|
|
|
|
|
|
|
typedef struct cli {
|
1999-12-06 12:34:45 +00:00
|
|
|
node n; /* Node in list of all log hooks */
|
1999-10-29 12:10:10 +00:00
|
|
|
pool *pool;
|
2023-01-19 09:53:09 +00:00
|
|
|
struct birdsock *sock; /* Underlying socket */
|
2022-12-10 16:32:42 +00:00
|
|
|
byte *rx_buf, *rx_pos; /* sysdep */
|
1999-10-29 12:10:10 +00:00
|
|
|
struct cli_out *tx_buf, *tx_pos, *tx_write;
|
|
|
|
event *event;
|
1999-10-31 15:43:44 +00:00
|
|
|
void (*cont)(struct cli *c);
|
2024-05-02 09:39:34 +00:00
|
|
|
void (*cleanup)(struct cli *c); /* The CLI has closed prematurely */
|
1999-10-31 15:43:44 +00:00
|
|
|
void *rover; /* Private to continuation routine */
|
2024-06-13 10:29:21 +00:00
|
|
|
struct config *main_config; /* Main config currently in use */
|
1999-10-31 15:43:44 +00:00
|
|
|
int last_reply;
|
2010-02-21 08:57:26 +00:00
|
|
|
int restricted; /* CLI is restricted to read-only commands */
|
Parse CLI commands. We use the same parser as for configuration files (because
we want to allow filter and similar complex constructs to be used in commands
and we should avoid code duplication), only with CLI_MARKER token prepended
before the whole input.
Defined macro CF_CLI(cmd, args, help) for defining CLI commands in .Y files.
The first argument specifies the command itself, the remaining two arguments
are copied to the help file (er, will be copied after the help file starts
to exist). This macro automatically creates a skeleton rule for the command,
you only need to append arguments as in:
CF_CLI(STEAL MONEY, <$>, [[Steal <$> US dollars or equivalent in any other currency]]): NUM {
cli_msg(0, "%d$ stolen", $3);
} ;
Also don't forget to reset lexer state between inputs.
1999-10-31 17:47:47 +00:00
|
|
|
struct linpool *parser_pool; /* Pool used during parsing */
|
2015-05-19 06:53:34 +00:00
|
|
|
uint log_mask; /* Mask of allowed message levels */
|
|
|
|
uint log_threshold; /* When free < log_threshold, store only important messages */
|
|
|
|
uint async_msg_size; /* Total size of async messages queued in tx_buf */
|
1999-10-29 12:10:10 +00:00
|
|
|
} cli;
|
|
|
|
|
2024-06-24 09:09:46 +00:00
|
|
|
struct cli_config {
|
|
|
|
#define TLIST_PREFIX cli_config
|
|
|
|
#define TLIST_TYPE struct cli_config
|
|
|
|
#define TLIST_ITEM n
|
|
|
|
#define TLIST_DEFINED_BEFORE
|
|
|
|
#define TLIST_WANT_ADD_TAIL
|
2024-06-24 09:10:07 +00:00
|
|
|
#define TLIST_WANT_WALK
|
2024-06-24 09:09:46 +00:00
|
|
|
TLIST_DEFAULT_NODE;
|
|
|
|
const char *name;
|
2024-06-24 09:10:07 +00:00
|
|
|
struct config *config;
|
2024-06-24 09:09:46 +00:00
|
|
|
uint uid, gid, mode;
|
2024-06-24 11:46:12 +00:00
|
|
|
_Bool restricted;
|
2024-06-24 09:09:46 +00:00
|
|
|
};
|
|
|
|
#include "lib/tlists.h"
|
|
|
|
|
2024-06-24 09:10:07 +00:00
|
|
|
void cli_config_listen(struct cli_config *, const char *);
|
|
|
|
|
1999-10-29 12:10:10 +00:00
|
|
|
extern pool *cli_pool;
|
Parse CLI commands. We use the same parser as for configuration files (because
we want to allow filter and similar complex constructs to be used in commands
and we should avoid code duplication), only with CLI_MARKER token prepended
before the whole input.
Defined macro CF_CLI(cmd, args, help) for defining CLI commands in .Y files.
The first argument specifies the command itself, the remaining two arguments
are copied to the help file (er, will be copied after the help file starts
to exist). This macro automatically creates a skeleton rule for the command,
you only need to append arguments as in:
CF_CLI(STEAL MONEY, <$>, [[Steal <$> US dollars or equivalent in any other currency]]): NUM {
cli_msg(0, "%d$ stolen", $3);
} ;
Also don't forget to reset lexer state between inputs.
1999-10-31 17:47:47 +00:00
|
|
|
extern struct cli *this_cli; /* Used during parsing */
|
1999-10-29 12:10:10 +00:00
|
|
|
|
2012-12-26 11:40:48 +00:00
|
|
|
#define CLI_ASYNC_CODE 10000
|
|
|
|
|
1999-10-31 15:43:44 +00:00
|
|
|
/* Functions to be called by command handlers */
|
|
|
|
|
|
|
|
void cli_printf(cli *, int, char *, ...);
|
1999-11-25 15:34:51 +00:00
|
|
|
#define cli_msg(x...) cli_printf(this_cli, x)
|
1999-10-31 15:43:44 +00:00
|
|
|
|
2020-05-14 01:48:17 +00:00
|
|
|
static inline void cli_separator(cli *c)
|
|
|
|
{ if (c->last_reply) cli_printf(c, -c->last_reply, ""); };
|
|
|
|
|
1999-10-31 15:43:44 +00:00
|
|
|
/* Functions provided to sysdep layer */
|
|
|
|
|
2024-11-28 11:07:30 +00:00
|
|
|
cli *cli_new(struct birdsock *, struct cli_config *);
|
1999-10-29 12:10:10 +00:00
|
|
|
void cli_init(void);
|
|
|
|
void cli_free(cli *);
|
|
|
|
void cli_kick(cli *);
|
|
|
|
void cli_written(cli *);
|
|
|
|
|
2010-02-21 08:57:26 +00:00
|
|
|
static inline int cli_access_restricted(void)
|
|
|
|
{
|
|
|
|
if (this_cli && this_cli->restricted)
|
|
|
|
return (cli_printf(this_cli, 8007, "Access denied"), 1);
|
|
|
|
else
|
|
|
|
return 0;
|
|
|
|
}
|
|
|
|
|
1999-10-31 15:43:44 +00:00
|
|
|
/* Functions provided by sysdep layer */
|
1999-10-29 12:10:10 +00:00
|
|
|
|
2009-07-14 12:18:54 +00:00
|
|
|
void cli_write_trigger(cli *);
|
1999-10-29 12:10:10 +00:00
|
|
|
int cli_get_command(cli *);
|
|
|
|
|
|
|
|
#endif
|