This repository has been archived on 2024-04-08. You can view files and clone it, but cannot push or open issues or pull requests.
magicka/jamlib-1.4.7/doc/JAM_WriteMBHeader.3
2016-03-22 12:08:00 +10:00

60 lines
1.3 KiB
Groff

.\" $Id: JAM_WriteMBHeader.3,v 1.1 2002/11/09 00:37:16 raorn Exp $
.\"
.TH JAM_WriteMBHeader 3 2002-11-07 "" "JAM subroutine library"
.SH NAME
JAM_WriteMBHeader \- Write message base header
.SH SYNOPSIS
.nf
.B #include <jamlib/jam.h>
.BI "int JAM_WriteMBHeader(s_JamBase* " Base_PS ","
.BI " s_JamBaseHeader* " Header_PS ");"
.RE
.fi
.SH DESCRIPTION
Increases the ModCounter field by one, resets the header signature
and writes the message base header to the start of the JAM header
file.
.SS Arguments
.TP
.I Base_PS
The message base to use
.TP
.I Header_PS
A pointer to the base header to be stored
.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 Base_PS or Header_PS is NULL
.TP
.B JAM_NOT_LOCKED
if the message base is not locked
.SH EXAMPLES
.nf
s_JamBaseHeader BaseHeader_S;
int Result_I;
/* modify header here */
Result_I = JAM_WriteMBHeader(&BaseHeader_S);
if (Result_I)
printf("JAM_WriteMBHeader returned %d.\\n", Result_I);
.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_ReadMBHeader (3),
.BR JAM_LockMB (3),
.BR JAM_Errno (3)
.\" vim: ft=nroff