0
|
1 /*
|
|
2 request.h
|
|
3
|
|
4 Collection of requested articles.
|
|
5
|
|
6 $Id: request.h 3 2000-01-04 11:35:42Z enz $
|
|
7 */
|
|
8
|
|
9 #ifndef REQ_H
|
|
10 #define REQ_H
|
|
11
|
|
12 #include "common.h"
|
|
13
|
|
14 /* Is request for message msgId from server serv already recorded? This
|
|
15 function has no error detection facility. On error, FALSE is returned.
|
|
16 Nevertheless, errors are logged. */
|
|
17 Bool
|
|
18 Req_contains( const char *serv, const char *msgId );
|
|
19
|
|
20 /* Add request for message "msgId" from server "serv". Return TRUE if
|
|
21 successful. */
|
|
22 Bool
|
|
23 Req_add( const char *serv, const char *msgId );
|
|
24
|
|
25 /* Remove request for message msgIg from server serv. This function does
|
|
26 not return any errors. Nevertheless, they are logged. */
|
|
27 void
|
|
28 Req_remove( const char *serv, const char *msgId );
|
|
29
|
|
30 /* Begin iteration through all messages requested from one server. Return
|
|
31 TRUE if there are any requests. Save first message ID in msgId. On
|
|
32 error, it is logged, and FALSE is returned.
|
|
33 */
|
|
34 Bool
|
|
35 Req_first( const char *serv, Str msgId );
|
|
36
|
|
37 /* Continue iteration. Return TRUE on success, FALSE when there are no more
|
|
38 requests. Save message ID in msgId. On error, it is logged, and FALSE is
|
|
39 returned. */
|
|
40 Bool
|
|
41 Req_next( Str msgId );
|
|
42
|
|
43 /* Get exclusive access to the request files. Refresh cache as necessary. */
|
|
44 Bool
|
|
45 Req_open(void);
|
|
46
|
|
47 /* Write changes to disk */
|
|
48 void
|
|
49 Req_close(void);
|
|
50
|
|
51 #endif
|