/usr/include/ncbi/mla2api.h is in libncbi6-dev 6.1.20110713-3ubuntu2.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 | /* mla2api.h
* ===========================================================================
*
* PUBLIC DOMAIN NOTICE
* National Center for Biotechnology Information (NCBI)
*
* This software/database is a "United States Government Work" under the
* terms of the United States Copyright Act. It was written as part of
* the author's official duties as a United States Government employee and
* thus cannot be copyrighted. This software/database is freely available
* to the public for use. The National Library of Medicine and the U.S.
* Government do not place any restriction on its use or reproduction.
* We would, however, appreciate having the NCBI and the author cited in
* any work or product based on this material
*
* Although all reasonable efforts have been taken to ensure the accuracy
* and reliability of the software and data, the NLM and the U.S.
* Government do not and cannot warrant the performance or results that
* may be obtained by using this software or data. The NLM and the U.S.
* Government disclaim all warranties, express or implied, including
* warranties of performance, merchantability or fitness for any particular
* purpose.
*
* ===========================================================================
*
* File Name: mla2api.h
*
* Author: Jonathan Kans
*
* Version Creation Date: 1/30/07
*
* $Revision: 1.7 $
*
* File Description:
*
* Modifications:
* --------------------------------------------------------------------------
*
* ==========================================================================
*/
#ifndef _MLA2API_
#define _MLA2API_
#include <ncbi.h>
#include <asn.h>
#include <mlkludge.h>
#include <objmla2.h>
#include <urlquery.h>
#undef NLM_EXTERN
#ifdef NLM_IMPORT
#define NLM_EXTERN NLM_IMPORT
#else
#define NLM_EXTERN extern
#endif
#ifdef __cplusplus
extern "C" {
#endif
/* low-level connection functions */
NLM_EXTERN CONN Mla2OpenConnection (void);
NLM_EXTERN MlaBackPtr Mla2WaitForReply (
CONN conn
);
/*
Mla2SynchronousQuery opens connection, sends
MlaRequestPtr ASN.1 query, and waits for reply,
cleaning up connection afterwards.
*/
NLM_EXTERN MlaBackPtr Mla2SynchronousQuery (
MlaRequestPtr mrp
);
/*
Mla2AsynchronousQuery opens connection, sends
request, and queues completion routine using urlquery
queueing mechanism.
Mla2CheckQueue should be called several times a
second with a timer. It calls QUERY_CheckQueue to
poll connection, which calls completion routine when
result is available, cleaning up connection afterwards.
Mla2ReadReply takes conn and status parameters from
completion routine and reads MlaBackPtr.
*/
NLM_EXTERN Boolean Mla2AsynchronousQuery (
MlaRequestPtr mrp,
QUEUE* queue,
QueryResultProc resultproc,
VoidPtr userdata
);
NLM_EXTERN Int4 Mla2CheckQueue (
QUEUE* queue
);
NLM_EXTERN MlaBackPtr Mla2ReadReply (
CONN conn,
EIO_Status status
);
/* request creation functions */
NLM_EXTERN MlaRequestPtr Mla2CreateJournalTitleRequest (
CharPtr journal_name
);
NLM_EXTERN MlaRequestPtr Mla2CreateCitArtJournalRequest (
CitArtPtr cap
);
NLM_EXTERN MlaRequestPtr Mla2CreateCitArtMatchRequest (
CitArtPtr cap
);
NLM_EXTERN MlaRequestPtr Mla2CreateCitationtMatchRequest (
CharPtr author,
CharPtr journal,
CharPtr volume,
CharPtr page,
Int4 year,
CharPtr title
);
NLM_EXTERN MlaRequestPtr Mla2CreatePubFetchRequest (
Int4 pmid
);
/*
reply extraction functions - these do not free the MlaBackPtr,
but unlink the internal structure so MlaBackFree can be called
*/
NLM_EXTERN TitleMsgListPtr Mla2ExtractJournalTitleReply (
MlaBackPtr mbp
);
NLM_EXTERN Int4 Mla2ExtractCitMatchReply (
MlaBackPtr mbp
);
NLM_EXTERN CitArtPtr Mla2ExtractPubFetchReply (
MlaBackPtr mbp
);
/* utility functions */
NLM_EXTERN void ChangeCitArtMLAuthorsToSTD (
CitArtPtr cap
);
NLM_EXTERN void ChangeMlaBackMLAuthorsToSTD (
MlaBackPtr mbp
);
NLM_EXTERN Boolean Mla2IsEPubOnlyJournal (
CharPtr jta,
Int2Ptr starting_yearP
);
/*
Mla2CorrectCitArt takes the original and fetched CitArt and
fixes author types, compares author lists for differences,
restores consortium authors, and other automatic cleanup
functions to be determined with experience
*/
NLM_EXTERN Int2 Mla2CorrectCitArt (
CitArtPtr newcap,
CitArtPtr oldcap
);
#ifdef __cplusplus
}
#endif
#undef NLM_EXTERN
#ifdef NLM_EXPORT
#define NLM_EXTERN NLM_EXPORT
#else
#define NLM_EXTERN
#endif
#endif /* _MLA2API_ */
|