/*
Bacula® - The Network Backup Solution
Copyright (C) 2000-2007 Free Software Foundation Europe e.V.
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 and included
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
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., 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.
*/
/*
*
* Utility routines for "tool" programs such as bscan, bls,
* bextract, ... Some routines also used by Bacula.
*
* Kern Sibbald, MM
*
* Normally nothing in this file is called by the Storage
* daemon because we interact more directly with the user
* i.e. printf, ...
*
* Version $Id: butil.c 5038 2007-06-18 19:29:26Z kerns $
*/
#include "bacula.h"
#include "stored.h"
/* Forward referenced functions */
static DCR *setup_to_access_device(JCR *jcr, char *dev_name, const char *VolumeName, int mode);
static DEVRES *find_device_res(char *device_name, int mode);
static void my_free_jcr(JCR *jcr);
/* Imported variables -- eliminate some day */
extern char *configfile;
#ifdef DEBUG
char *rec_state_to_str(DEV_RECORD *rec)
{
static char buf[200];
buf[0] = 0;
if (rec->state & REC_NO_HEADER) {
strcat(buf, _("Nohdr,"));
}
if (is_partial_record(rec)) {
strcat(buf, _("partial,"));
}
if (rec->state & REC_BLOCK_EMPTY) {
strcat(buf, _("empty,"));
}
if (rec->state & REC_NO_MATCH) {
strcat(buf, _("Nomatch,"));
}
if (rec->state & REC_CONTINUATION) {
strcat(buf, _("cont,"));
}
if (buf[0]) {
buf[strlen(buf)-1] = 0;
}
return buf;
}
#endif
/*
* Setup a "daemon" JCR for the various standalone
* tools (e.g. bls, bextract, bscan, ...)
*/
JCR *setup_jcr(const char *name, char *dev_name, BSR *bsr,
const char *VolumeName, int mode)
{
DCR *dcr;
JCR *jcr = new_jcr(sizeof(JCR), my_free_jcr);
jcr->bsr = bsr;
jcr->VolSessionId = 1;
jcr->VolSessionTime = (uint32_t)time(NULL);
jcr->NumReadVolumes = 0;
jcr->NumWriteVolumes = 0;
jcr->JobId = 0;
jcr->JobType = JT_CONSOLE;
jcr->JobLevel = L_FULL;
jcr->JobStatus = JS_Terminated;
jcr->where = bstrdup("");
jcr->job_name = get_pool_memory(PM_FNAME);
pm_strcpy(jcr->job_name, "Dummy.Job.Name");
jcr->client_name = get_pool_memory(PM_FNAME);
pm_strcpy(jcr->client_name, "Dummy.Client.Name");
bstrncpy(jcr->Job, name, sizeof(jcr->Job));
jcr->fileset_name = get_pool_memory(PM_FNAME);
pm_strcpy(jcr->fileset_name, "Dummy.fileset.name");
jcr->fileset_md5 = get_pool_memory(PM_FNAME);
pm_strcpy(jcr->fileset_md5, "Dummy.fileset.md5");
init_autochangers();
create_volume_list();
dcr = setup_to_access_device(jcr, dev_name, VolumeName, mode);
if (!dcr) {
return NULL;
}
if (!bsr && VolumeName) {
bstrncpy(dcr->VolumeName, VolumeName, sizeof(dcr->VolumeName));
}
bstrncpy(dcr->pool_name, "Default", sizeof(dcr->pool_name));
bstrncpy(dcr->pool_type, "Backup", sizeof(dcr->pool_type));
return jcr;
}
/*
* Setup device, jcr, and prepare to access device.
* If the caller wants read access, acquire the device, otherwise,
* the caller will do it.
*/
static DCR *setup_to_access_device(JCR *jcr, char *dev_name,
const char *VolumeName, int mode)
{
DEVICE *dev;
char *p;
DEVRES *device;
DCR *dcr;
char VolName[MAX_NAME_LENGTH];
init_reservations_lock();
/*
* If no volume name already given and no bsr, and it is a file,
* try getting name from Filename
*/
if (VolumeName) {
bstrncpy(VolName, VolumeName, sizeof(VolName));
if (strlen(VolumeName) >= MAX_NAME_LENGTH) {
Jmsg0(jcr, M_ERROR, 0, _("Volume name or names is too long. Please use a .bsr file.\n"));
}
} else {
VolName[0] = 0;
}
if (!jcr->bsr && VolName[0] == 0) {
if (strncmp(dev_name, "/dev/", 5) != 0) {
/* Try stripping file part */
p = dev_name + strlen(dev_name);
while (p >= dev_name && !IsPathSeparator(*p))
p--;
if (IsPathSeparator(*p)) {
bstrncpy(VolName, p+1, sizeof(VolName));
*p = 0;
}
}
}
if ((device=find_device_res(dev_name, mode)) == NULL) {
Jmsg2(jcr, M_FATAL, 0, _("Cannot find device \"%s\" in config file %s.\n"),
dev_name, configfile);
return NULL;
}
dev = init_dev(jcr, device);
if (!dev) {
Jmsg1(jcr, M_FATAL, 0, _("Cannot init device %s\n"), dev_name);
return NULL;
}
device->dev = dev;
jcr->dcr = dcr = new_dcr(jcr, NULL, dev);
if (VolName[0]) {
bstrncpy(dcr->VolumeName, VolName, sizeof(dcr->VolumeName));
}
bstrncpy(dcr->dev_name, device->device_name, sizeof(dcr->dev_name));
create_restore_volume_list(jcr);
if (mode) { /* read only access? */
Dmsg0(100, "Acquire device for read\n");
if (!acquire_device_for_read(dcr)) {
return NULL;
}
jcr->read_dcr = dcr;
} else {
if (!first_open_device(dcr)) {
Jmsg1(jcr, M_FATAL, 0, _("Cannot open %s\n"), dev->print_name());
return NULL;
}
jcr->dcr = dcr; /* write dcr */
}
return dcr;
}
/*
* Called here when freeing JCR so that we can get rid
* of "daemon" specific memory allocated.
*/
static void my_free_jcr(JCR *jcr)
{
if (jcr->job_name) {
free_pool_memory(jcr->job_name);
jcr->job_name = NULL;
}
if (jcr->client_name) {
free_pool_memory(jcr->client_name);
jcr->client_name = NULL;
}
if (jcr->fileset_name) {
free_pool_memory(jcr->fileset_name);
jcr->fileset_name = NULL;
}
if (jcr->fileset_md5) {
free_pool_memory(jcr->fileset_md5);
jcr->fileset_md5 = NULL;
}
if (jcr->VolList) {
free_restore_volume_list(jcr);
}
if (jcr->dcr) {
free_dcr(jcr->dcr);
jcr->dcr = NULL;
}
return;
}
/*
* Search for device resource that corresponds to
* device name on command line (or default).
*
* Returns: NULL on failure
* Device resource pointer on success
*/
static DEVRES *find_device_res(char *device_name, int read_access)
{
bool found = false;
DEVRES *device;
Dmsg0(900, "Enter find_device_res\n");
LockRes();
foreach_res(device, R_DEVICE) {
Dmsg2(900, "Compare %s and %s\n", device->device_name, device_name);
if (strcmp(device->device_name, device_name) == 0) {
found = true;
break;
}
}
if (!found) {
/* Search for name of Device resource rather than archive name */
if (device_name[0] == '"') {
int len = strlen(device_name);
bstrncpy(device_name, device_name+1, len+1);
len--;
if (len > 0) {
device_name[len-1] = 0; /* zap trailing " */
}
}
foreach_res(device, R_DEVICE) {
Dmsg2(900, "Compare %s and %s\n", device->hdr.name, device_name);
if (strcmp(device->hdr.name, device_name) == 0) {
found = true;
break;
}
}
}
UnlockRes();
if (!found) {
Pmsg2(0, _("Could not find device \"%s\" in config file %s.\n"), device_name,
configfile);
return NULL;
}
if (read_access) {
Pmsg1(0, _("Using device: \"%s\" for reading.\n"), device_name);
}
else {
Pmsg1(0, _("Using device: \"%s\" for writing.\n"), device_name);
}
return device;
}
/*
* Device got an error, attempt to analyse it
*/
void display_tape_error_status(JCR *jcr, DEVICE *dev)
{
uint32_t status;
status = status_dev(dev);
Dmsg1(20, "Device status: %x\n", status);
if (status & BMT_EOD)
Jmsg(jcr, M_ERROR, 0, _("Unexpected End of Data\n"));
else if (status & BMT_EOT)
Jmsg(jcr, M_ERROR, 0, _("Unexpected End of Tape\n"));
else if (status & BMT_EOF)
Jmsg(jcr, M_ERROR, 0, _("Unexpected End of File\n"));
else if (status & BMT_DR_OPEN)
Jmsg(jcr, M_ERROR, 0, _("Tape Door is Open\n"));
else if (!(status & BMT_ONLINE))
Jmsg(jcr, M_ERROR, 0, _("Unexpected Tape is Off-line\n"));
}
syntax highlighted by Code2HTML, v. 0.9.1