/*
- *
- * Bacula Director -- User Agent Commands
- * These are "dot" commands, i.e. commands preceded
- * by a period. These commands are meant to be used
- * by a program, so there is no prompting, and the
- * returned results are (supposed to be) predictable.
- *
- * Kern Sibbald, April MMII
- *
- * Version $Id$
- */
+ Bacula® - The Network Backup Solution
-/*
- Copyright (C) 2002 Kern Sibbald and John Walker
+ Copyright (C) 2002-2007 Free Software Foundation Europe e.V.
- This program is free software; you can redistribute it and/or
- modify it under the terms of the GNU General Public License as
- published by the Free Software Foundation; either version 2 of
- the License, or (at your option) any later version.
+ The main author of Bacula is Kern Sibbald, with contributions from
+ many others, a complete list can be found in the file AUTHORS.
+ This program is Free Software; you can redistribute it and/or
+ modify it under the terms of version two of the GNU General Public
+ License as published by the Free Software Foundation plus additions
+ that are listed in the file LICENSE.
- This program is distributed in the hope that it will be useful,
- but WITHOUT ANY WARRANTY; without even the implied warranty of
+ 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, write to the Free
- Software Foundation, Inc., 59 Temple Place - Suite 330, Boston,
- MA 02111-1307, USA.
+ You should have received a copy of the GNU General Public License
+ along with this program; if not, write to the Free Software
+ Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
+ 02110-1301, USA.
+ Bacula® is a registered trademark of John Walker.
+ The licensor of Bacula is the Free Software Foundation Europe
+ (FSFE), Fiduciary Program, Sumatrastrasse 25, 8006 Zürich,
+ Switzerland, email:ftf@fsfeurope.org.
+*/
+/*
+ *
+ * Bacula Director -- User Agent Commands
+ * These are "dot" commands, i.e. commands preceded
+ * by a period. These commands are meant to be used
+ * by a program, so there is no prompting, and the
+ * returned results are (supposed to be) predictable.
+ *
+ * Kern Sibbald, April MMII
+ *
+ * Version $Id$
*/
#include "bacula.h"
extern int r_first;
extern int r_last;
extern struct s_res resources[];
-extern char my_name[];
/* Imported functions */
-extern int qmessagescmd(UAContext *ua, char *cmd);
-extern int quitcmd(UAContext *ua, char *cmd);
+extern void do_messages(UAContext *ua, const char *cmd);
+extern int quit_cmd(UAContext *ua, const char *cmd);
+extern int qhelp_cmd(UAContext *ua, const char *cmd);
+extern bool dot_status_cmd(UAContext *ua, const char *cmd);
+
/* Forward referenced functions */
-static int diecmd(UAContext *ua, char *cmd);
-static int jobscmd(UAContext *ua, char *cmd);
-static int filesetscmd(UAContext *ua, char *cmd);
-static int clientscmd(UAContext *ua, char *cmd);
-static int msgscmd(UAContext *ua, char *cmd);
-static int poolscmd(UAContext *ua, char *cmd);
-static int storagecmd(UAContext *ua, char *cmd);
-static int defaultscmd(UAContext *ua, char *cmd);
-static int typescmd(UAContext *ua, char *cmd);
-static int levelscmd(UAContext *ua, char *cmd);
-
-struct cmdstruct { char *key; int (*func)(UAContext *ua, char *cmd); char *help; };
+static bool diecmd(UAContext *ua, const char *cmd);
+static bool jobscmd(UAContext *ua, const char *cmd);
+static bool filesetscmd(UAContext *ua, const char *cmd);
+static bool clientscmd(UAContext *ua, const char *cmd);
+static bool msgscmd(UAContext *ua, const char *cmd);
+static bool poolscmd(UAContext *ua, const char *cmd);
+static bool storagecmd(UAContext *ua, const char *cmd);
+static bool defaultscmd(UAContext *ua, const char *cmd);
+static bool typescmd(UAContext *ua, const char *cmd);
+static bool backupscmd(UAContext *ua, const char *cmd);
+static bool levelscmd(UAContext *ua, const char *cmd);
+static bool getmsgscmd(UAContext *ua, const char *cmd);
+
+static bool api_cmd(UAContext *ua, const char *cmd);
+static bool dot_quit_cmd(UAContext *ua, const char *cmd);
+static bool dot_help_cmd(UAContext *ua, const char *cmd);
+
+struct cmdstruct { const char *key; bool (*func)(UAContext *ua, const char *cmd); const char *help; };
static struct cmdstruct commands[] = {
- { N_(".die"), diecmd, NULL},
- { N_(".jobs"), jobscmd, NULL},
- { N_(".filesets"), filesetscmd, NULL},
- { N_(".clients"), clientscmd, NULL},
- { N_(".msgs"), msgscmd, NULL},
- { N_(".pools"), poolscmd, NULL},
- { N_(".types"), typescmd, NULL},
- { N_(".levels"), levelscmd, NULL},
- { N_(".storage"), storagecmd, NULL},
- { N_(".defaults"), defaultscmd, NULL},
- { N_(".messages"), qmessagescmd, NULL},
- { N_(".quit"), quitcmd, NULL},
- { N_(".exit"), quitcmd, NULL}
- };
-#define comsize (sizeof(commands)/sizeof(struct cmdstruct))
+ { NT_(".api"), api_cmd, NULL},
+ { NT_(".backups"), backupscmd, NULL},
+ { NT_(".clients"), clientscmd, NULL},
+ { NT_(".defaults"), defaultscmd, NULL},
+ { NT_(".die"), diecmd, NULL},
+ { NT_(".exit"), dot_quit_cmd, NULL},
+ { NT_(".filesets"), filesetscmd, NULL},
+ { NT_(".help"), dot_help_cmd, NULL},
+ { NT_(".jobs"), jobscmd, NULL},
+ { NT_(".levels"), levelscmd, NULL},
+ { NT_(".messages"), getmsgscmd, NULL},
+ { NT_(".msgs"), msgscmd, NULL},
+ { NT_(".pools"), poolscmd, NULL},
+ { NT_(".quit"), dot_quit_cmd, NULL},
+ { NT_(".status"), dot_status_cmd, NULL},
+ { NT_(".storage"), storagecmd, NULL},
+ { NT_(".types"), typescmd, NULL}
+ };
+#define comsize ((int)(sizeof(commands)/sizeof(struct cmdstruct)))
/*
* Execute a command from the UA
*/
-int do_a_dot_command(UAContext *ua, char *cmd)
+int do_a_dot_command(UAContext *ua, const char *cmd)
{
- unsigned int i;
- int len, stat;
- int found;
-
- found = 0;
- stat = 1;
+ int i;
+ int len;
+ bool ok = false;
+ bool found = false;
+ BSOCK *sock = ua->UA_sock;
- Dmsg1(200, "Dot command: %s\n", ua->UA_sock->msg);
+ Dmsg1(1400, "Dot command: %s\n", ua->UA_sock->msg);
if (ua->argc == 0) {
return 1;
}
len = strlen(ua->argk[0]);
if (len == 1) {
- return 1; /* no op */
+ return 1; /* no op */
}
- for (i=0; i<comsize; i++) { /* search for command */
+ for (i=0; i<comsize; i++) { /* search for command */
if (strncasecmp(ua->argk[0], _(commands[i].key), len) == 0) {
- stat = (*commands[i].func)(ua, cmd); /* go execute command */
- found = 1;
- break;
+ bool gui = ua->gui;
+ ua->gui = true;
+ if (ua->api) sock->signal(BNET_CMD_BEGIN);
+ ok = (*commands[i].func)(ua, cmd); /* go execute command */
+ ua->gui = gui;
+ found = true;
+ break;
}
}
if (!found) {
- strcat(ua->UA_sock->msg, _(": is an illegal command\n"));
- ua->UA_sock->msglen = strlen(ua->UA_sock->msg);
- bnet_send(ua->UA_sock);
+ pm_strcat(sock->msg, _(": is an invalid command\n"));
+ sock->msglen = strlen(sock->msg);
+ sock->send();
+ if (ua->api) sock->signal(BNET_INVALID_CMD);
}
- return stat;
+ if (ua->api) sock->signal(ok?BNET_CMD_OK:BNET_CMD_FAILED);
+ return 1;
+}
+
+static bool dot_quit_cmd(UAContext *ua, const char *cmd)
+{
+ quit_cmd(ua, cmd);
+ return true;
+}
+
+static bool dot_help_cmd(UAContext *ua, const char *cmd)
+{
+ qhelp_cmd(ua, cmd);
+ return true;
+}
+
+static bool getmsgscmd(UAContext *ua, const char *cmd)
+{
+ if (console_msg_pending) {
+ do_messages(ua, cmd);
+ }
+ return 1;
}
/*
- * Create segmentation fault
+ * Create segmentation fault
*/
-static int diecmd(UAContext *ua, char *cmd)
+static bool diecmd(UAContext *ua, const char *cmd)
{
JCR *jcr = NULL;
int a;
-
+
+ bsendmsg(ua, _("The Director will segment fault.\n"));
a = jcr->JobId; /* ref NULL pointer */
- return 0;
+ jcr->JobId = 1000; /* another ref NULL pointer */
+ return true;
}
-static int jobscmd(UAContext *ua, char *cmd)
+static bool jobscmd(UAContext *ua, const char *cmd)
{
JOB *job = NULL;
LockRes();
while ( (job = (JOB *)GetNextRes(R_JOB, (RES *)job)) ) {
- bsendmsg(ua, "%s\n", job->hdr.name);
+ if (acl_access_ok(ua, Job_ACL, job->name())) {
+ bsendmsg(ua, "%s\n", job->name());
+ }
}
UnlockRes();
- return 1;
+ return true;
}
-static int filesetscmd(UAContext *ua, char *cmd)
+static bool filesetscmd(UAContext *ua, const char *cmd)
{
FILESET *fs = NULL;
LockRes();
while ( (fs = (FILESET *)GetNextRes(R_FILESET, (RES *)fs)) ) {
- bsendmsg(ua, "%s\n", fs->hdr.name);
+ if (acl_access_ok(ua, FileSet_ACL, fs->name())) {
+ bsendmsg(ua, "%s\n", fs->name());
+ }
}
UnlockRes();
- return 1;
+ return true;
}
-static int clientscmd(UAContext *ua, char *cmd)
+static bool clientscmd(UAContext *ua, const char *cmd)
{
CLIENT *client = NULL;
LockRes();
while ( (client = (CLIENT *)GetNextRes(R_CLIENT, (RES *)client)) ) {
- bsendmsg(ua, "%s\n", client->hdr.name);
+ if (acl_access_ok(ua, Client_ACL, client->name())) {
+ bsendmsg(ua, "%s\n", client->name());
+ }
}
UnlockRes();
- return 1;
+ return true;
}
-static int msgscmd(UAContext *ua, char *cmd)
+static bool msgscmd(UAContext *ua, const char *cmd)
{
MSGS *msgs = NULL;
LockRes();
while ( (msgs = (MSGS *)GetNextRes(R_MSGS, (RES *)msgs)) ) {
- bsendmsg(ua, "%s\n", msgs->hdr.name);
+ bsendmsg(ua, "%s\n", msgs->name());
}
UnlockRes();
- return 1;
+ return true;
}
-static int poolscmd(UAContext *ua, char *cmd)
+static bool poolscmd(UAContext *ua, const char *cmd)
{
POOL *pool = NULL;
LockRes();
while ( (pool = (POOL *)GetNextRes(R_POOL, (RES *)pool)) ) {
- bsendmsg(ua, "%s\n", pool->hdr.name);
+ if (acl_access_ok(ua, Pool_ACL, pool->name())) {
+ bsendmsg(ua, "%s\n", pool->name());
+ }
}
UnlockRes();
- return 1;
+ return true;
}
-static int storagecmd(UAContext *ua, char *cmd)
+static bool storagecmd(UAContext *ua, const char *cmd)
{
STORE *store = NULL;
LockRes();
while ( (store = (STORE *)GetNextRes(R_STORAGE, (RES *)store)) ) {
- bsendmsg(ua, "%s\n", store->hdr.name);
+ if (acl_access_ok(ua, Storage_ACL, store->name())) {
+ bsendmsg(ua, "%s\n", store->name());
+ }
}
UnlockRes();
- return 1;
+ return true;
}
-static int typescmd(UAContext *ua, char *cmd)
+static bool typescmd(UAContext *ua, const char *cmd)
{
bsendmsg(ua, "Backup\n");
bsendmsg(ua, "Restore\n");
bsendmsg(ua, "Admin\n");
bsendmsg(ua, "Verify\n");
- return 1;
+ bsendmsg(ua, "Migrate\n");
+ return true;
}
-static int levelscmd(UAContext *ua, char *cmd)
+static int client_backups_handler(void *ctx, int num_field, char **row)
+{
+ UAContext *ua = (UAContext *)ctx;
+ bsendmsg(ua, "| %s | %s | %s | %s | %s | %s | %s | %s |\n",
+ row[0], row[1], row[2], row[3], row[4], row[5], row[6], row[7], row[8]);
+ return 0;
+}
+
+/*
+ * If this command is called, it tells the director that we
+ * are a program that wants a sort of API, and hence,
+ * we will probably suppress certain output, include more
+ * error codes, and most of all send back a good number
+ * of new signals that indicate whether or not the command
+ * succeeded.
+ */
+static bool api_cmd(UAContext *ua, const char *cmd)
+{
+ /* Eventually we will probably have several levels or
+ * capabilities enabled by this.
+ */
+ ua->api = 1;
+ return true;
+}
+
+/*
+ * Return the backups for this client
+ */
+static bool backupscmd(UAContext *ua, const char *cmd)
+{
+ if (!open_client_db(ua)) {
+ return true;
+ }
+ if (ua->argc != 3 || strcmp(ua->argk[1], "client") != 0 || strcmp(ua->argk[2], "fileset") != 0) {
+ return true;
+ }
+ if (!acl_access_ok(ua, Client_ACL, ua->argv[1]) ||
+ !acl_access_ok(ua, FileSet_ACL, ua->argv[2])) {
+ return true;
+ }
+ Mmsg(ua->cmd, client_backups, ua->argv[1], ua->argv[2]);
+ if (!db_sql_query(ua->db, ua->cmd, client_backups_handler, (void *)ua)) {
+ bsendmsg(ua, _("Query failed: %s. ERR=%s\n"), ua->cmd, db_strerror(ua->db));
+ return true;
+ }
+ return true;
+}
+
+
+
+static bool levelscmd(UAContext *ua, const char *cmd)
{
bsendmsg(ua, "Incremental\n");
bsendmsg(ua, "Full\n");
bsendmsg(ua, "Catalog\n");
bsendmsg(ua, "InitCatalog\n");
bsendmsg(ua, "VolumeToCatalog\n");
- return 1;
+ return true;
}
-
-
/*
* Return default values for a job
*/
-static int defaultscmd(UAContext *ua, char *cmd)
+static bool defaultscmd(UAContext *ua, const char *cmd)
{
- JOB *job;
- if (ua->argc == 2 && strcmp(ua->argk[1], "job") == 0) {
+ JOB *job;
+ CLIENT *client;
+ STORE *storage;
+ POOL *pool;
+
+ if (ua->argc != 2 || !ua->argv[1]) {
+ return true;
+ }
+
+ /* Job defaults */
+ if (strcmp(ua->argk[1], "job") == 0) {
+ if (!acl_access_ok(ua, Job_ACL, ua->argv[1])) {
+ return true;
+ }
job = (JOB *)GetResWithName(R_JOB, ua->argv[1]);
if (job) {
- bsendmsg(ua, "job=%s", job->hdr.name);
- bsendmsg(ua, "pool=%s", job->pool->hdr.name);
- bsendmsg(ua, "messages=%s", job->messages->hdr.name);
- bsendmsg(ua, "client=%s", job->client->hdr.name);
- bsendmsg(ua, "storage=%s", job->storage->hdr.name);
+ USTORE store;
+ bsendmsg(ua, "job=%s", job->name());
+ bsendmsg(ua, "pool=%s", job->pool->name());
+ bsendmsg(ua, "messages=%s", job->messages->name());
+ bsendmsg(ua, "client=%s", job->client->name());
+ get_job_storage(&store, job, NULL);
+ bsendmsg(ua, "storage=%s", store.store->name());
bsendmsg(ua, "where=%s", job->RestoreWhere?job->RestoreWhere:"");
- bsendmsg(ua, "level=%s", level_to_str(job->level));
+ bsendmsg(ua, "level=%s", level_to_str(job->JobLevel));
bsendmsg(ua, "type=%s", job_type_to_str(job->JobType));
- bsendmsg(ua, "fileset=%s", job->fileset->hdr.name);
+ bsendmsg(ua, "fileset=%s", job->fileset->name());
+ bsendmsg(ua, "enabled=%d", job->enabled);
+ bsendmsg(ua, "catalog=%s", job->client->catalog->name());
+ }
+ }
+ /* Client defaults */
+ else if (strcmp(ua->argk[1], "client") == 0) {
+ if (!acl_access_ok(ua, Client_ACL, ua->argv[1])) {
+ return true;
+ }
+ client = (CLIENT *)GetResWithName(R_CLIENT, ua->argv[1]);
+ if (client) {
+ bsendmsg(ua, "client=%s", client->name());
+ bsendmsg(ua, "address=%s", client->address);
+ bsendmsg(ua, "fdport=%d", client->FDport);
+ bsendmsg(ua, "file_retention=%d", client->FileRetention);
+ bsendmsg(ua, "job_retention=%d", client->JobRetention);
+ bsendmsg(ua, "autoprune=%d", client->AutoPrune);
+ bsendmsg(ua, "catalog=%s", client->catalog->name());
}
}
- return 1;
+ /* Storage defaults */
+ else if (strcmp(ua->argk[1], "storage") == 0) {
+ if (!acl_access_ok(ua, Storage_ACL, ua->argv[1])) {
+ return true;
+ }
+ storage = (STORE *)GetResWithName(R_STORAGE, ua->argv[1]);
+ DEVICE *device;
+ if (storage) {
+ bsendmsg(ua, "storage=%s", storage->name());
+ bsendmsg(ua, "address=%s", storage->address);
+ bsendmsg(ua, "enabled=%d", storage->enabled);
+ bsendmsg(ua, "media_type=%s", storage->media_type);
+ bsendmsg(ua, "sdport=%d", storage->SDport);
+ device = (DEVICE *)storage->device->first();
+ bsendmsg(ua, "device=%s", device->name());
+ if (storage->device->size() > 1) {
+ while ((device = (DEVICE *)storage->device->next())) {
+ bsendmsg(ua, ",%s", device->name());
+ }
+ }
+ }
+ }
+ /* Pool defaults */
+ else if (strcmp(ua->argk[1], "pool") == 0) {
+ if (!acl_access_ok(ua, Pool_ACL, ua->argv[1])) {
+ return true;
+ }
+ pool = (POOL *)GetResWithName(R_POOL, ua->argv[1]);
+ if (pool) {
+ bsendmsg(ua, "pool=%s", pool->name());
+ bsendmsg(ua, "pool_type=%s", pool->pool_type);
+ bsendmsg(ua, "label_format=%s", pool->label_format?pool->label_format:"");
+ bsendmsg(ua, "use_volume_once=%d", pool->use_volume_once);
+ bsendmsg(ua, "purge_oldest_volume=%d", pool->purge_oldest_volume);
+ bsendmsg(ua, "recycle_oldest_volume=%d", pool->recycle_oldest_volume);
+ bsendmsg(ua, "recycle_current_volume=%d", pool->recycle_current_volume);
+ bsendmsg(ua, "max_volumes=%d", pool->max_volumes);
+ bsendmsg(ua, "vol_retention=%d", pool->VolRetention);
+ bsendmsg(ua, "vol_use_duration=%d", pool->VolUseDuration);
+ bsendmsg(ua, "max_vol_jobs=%d", pool->MaxVolJobs);
+ bsendmsg(ua, "max_vol_files=%d", pool->MaxVolFiles);
+ bsendmsg(ua, "max_vol_bytes=%d", pool->MaxVolBytes);
+ bsendmsg(ua, "auto_prune=%d", pool->AutoPrune);
+ bsendmsg(ua, "recycle=%d", pool->Recycle);
+ }
+ }
+ return true;
}