NAME

JAM_RemoveMB - Remove a message base

SYNOPSIS

#include <jamlib/jam.h>
int JAM_RemoveMB(s_JamBase* ErrorBase_PS, uchar* Basename_PC);

DESCRIPTION

Deletes all files associated with a message base. No checking is done as to whether the message base is currently open or not.

Arguments

ErrorBase_PS: The message base in which to store the I/O error, if any. This parameter does NOT specify the message to be removed, it is only used for error tracking purposes. If an I/O error occurs when removing the message base files, this message base handler will simply hold the error code.
Basename_PC: The path and base filename of the message base to remove.

RETURN VALUE

0: if successful
JAM_IO_ERROR: if an I/O error occured. See JAM_Errno(3)
JAM_BAD_PARAM: if ErrorBase_PS is NULL

EXAMPLES

int        Result_I;
Result_I = JAM_RemoveMB(Base_PS, "/some/where/mynase");
if (Result_I) {
  printf("JAM_RemoveMB returned %d.0, Result_I);
  if (Result_I == JAM_IO_ERROR)
    printf("I/O error %d\n", JAM_Errno(ErrorBase_PS));
}

AUTHOR

This manual page was created by Sir Raorn <raorn@altlinux.ru>, based on original JAMlib documentation by Bjorn Stenberg <bjorn@haxx.nu> and Johan Billing <billing@df.lth.se>.