57 lines
1.5 KiB
Groff
57 lines
1.5 KiB
Groff
.\" $Id: JAM_RemoveMB.3,v 1.1 2002/11/09 00:37:16 raorn Exp $
|
|
.\"
|
|
.TH JAM_RemoveMB 3 2002-11-07 "" "JAM subroutine library"
|
|
.SH NAME
|
|
JAM_RemoveMB \- Remove a message base
|
|
.SH SYNOPSIS
|
|
.nf
|
|
.B #include <jamlib/jam.h>
|
|
|
|
.BI "int JAM_RemoveMB(s_JamBase* " ErrorBase_PS ", uchar* " Basename_PC ");"
|
|
.RE
|
|
.fi
|
|
.SH DESCRIPTION
|
|
Deletes all files associated with a message base. No checking is
|
|
done as to whether the message base is currently open or not.
|
|
.SS Arguments
|
|
.TP
|
|
.I ErrorBase_PS
|
|
The message base in which to store the I/O error, if any. This parameter does
|
|
\fBNOT\fP 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.
|
|
.TP
|
|
.I Basename_PC
|
|
The path and base filename of the message base to remove.
|
|
.SH RETURN VALUE
|
|
.TP
|
|
.B 0
|
|
if successful
|
|
.TP
|
|
.B JAM_IO_ERROR
|
|
if an I/O error occured. See
|
|
.BR JAM_Errno (3)
|
|
.TP
|
|
.B JAM_BAD_PARAM
|
|
if \fIErrorBase_PS\fP is NULL
|
|
.SH EXAMPLES
|
|
.nf
|
|
int Result_I;
|
|
|
|
Result_I = JAM_RemoveMB(Base_PS, "/some/where/mynase");
|
|
if (Result_I) {
|
|
printf("JAM_RemoveMB returned %d.\n", Result_I);
|
|
if (Result_I == JAM_IO_ERROR)
|
|
printf("I/O error %d\\n", JAM_Errno(ErrorBase_PS));
|
|
}
|
|
.fi
|
|
.SH 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>.
|
|
.SH SEE ALSO
|
|
.BR jamlib (3),
|
|
.BR JAM_CreateMB (3),
|
|
.BR JAM_Errno (3)
|
|
.\" vim: ft=nroff
|