mbx.h
上传用户:ycwykj01
上传日期:2007-01-04
资源大小:1819k
文件大小:4k
源码类别:

网络编程

开发平台:

Unix_Linux

  1. /*
  2.  * Program: MBX mail routines
  3.  *
  4.  * Author: Mark Crispin
  5.  * Networks and Distributed Computing
  6.  * Computing & Communications
  7.  * University of Washington
  8.  * Administration Building, AG-44
  9.  * Seattle, WA  98195
  10.  * Internet: MRC@CAC.Washington.EDU
  11.  *
  12.  * Date: 3 October 1995
  13.  * Last Edited: 21 September 1999
  14.  *
  15.  * Copyright 1999 by the University of Washington
  16.  *
  17.  *  Permission to use, copy, modify, and distribute this software and its
  18.  * documentation for any purpose and without fee is hereby granted, provided
  19.  * that the above copyright notice appears in all copies and that both the
  20.  * above copyright notice and this permission notice appear in supporting
  21.  * documentation, and that the name of the University of Washington not be
  22.  * used in advertising or publicity pertaining to distribution of the software
  23.  * without specific, written prior permission.  This software is made
  24.  * available "as is", and
  25.  * THE UNIVERSITY OF WASHINGTON DISCLAIMS ALL WARRANTIES, EXPRESS OR IMPLIED,
  26.  * WITH REGARD TO THIS SOFTWARE, INCLUDING WITHOUT LIMITATION ALL IMPLIED
  27.  * WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE, AND IN
  28.  * NO EVENT SHALL THE UNIVERSITY OF WASHINGTON BE LIABLE FOR ANY SPECIAL,
  29.  * INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES WHATSOEVER RESULTING FROM
  30.  * LOSS OF USE, DATA OR PROFITS, WHETHER IN AN ACTION OF CONTRACT, TORT
  31.  * (INCLUDING NEGLIGENCE) OR STRICT LIABILITY, ARISING OUT OF OR IN CONNECTION
  32.  * WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
  33.  *
  34.  */
  35. /* Build parameters */
  36. #define HDRSIZE 2048
  37. /* MBX I/O stream local data */
  38. typedef struct mbx_local {
  39.   unsigned int flagcheck: 1; /* if ping should sweep for flags */
  40.   unsigned int fullcheck: 1; /* if ping must sweep flags and expunged */
  41.   unsigned int expunged : 1; /* if one or more expunged messages */
  42.   int fd; /* file descriptor for I/O */
  43.   int ffuserflag; /* first free user flag */
  44.   off_t filesize; /* file size parsed */
  45.   time_t filetime; /* last file time */
  46.   time_t lastsnarf; /* last snarf time */
  47.   char *buf; /* temporary buffer */
  48.   unsigned long buflen; /* current size of temporary buffer */
  49. } MBXLOCAL;
  50. /* Convenient access to local data */
  51. #define LOCAL ((MBXLOCAL *) stream->local)
  52. /* Private driver flags, should be in mail.h? */
  53. #define fEXPUNGED 32768
  54. /* mbx_update_status() flags */
  55. #define mus_SYNC 1
  56. #define mus_EXPUNGE 2
  57. /* Function prototypes */
  58. DRIVER *mbx_valid (char *name);
  59. int mbx_isvalid (char *name,char *tmp);
  60. void *mbx_parameters (long function,void *value);
  61. void mbx_scan (MAILSTREAM *stream,char *ref,char *pat,char *contents);
  62. void mbx_list (MAILSTREAM *stream,char *ref,char *pat);
  63. void mbx_lsub (MAILSTREAM *stream,char *ref,char *pat);
  64. long mbx_create (MAILSTREAM *stream,char *mailbox);
  65. long mbx_delete (MAILSTREAM *stream,char *mailbox);
  66. long mbx_rename (MAILSTREAM *stream,char *old,char *newname);
  67. long mbx_status (MAILSTREAM *stream,char *mbx,long flags);
  68. MAILSTREAM *mbx_open (MAILSTREAM *stream);
  69. void mbx_close (MAILSTREAM *stream,long options);
  70. void mbx_flags (MAILSTREAM *stream,char *sequence,long flags);
  71. char *mbx_header (MAILSTREAM *stream,unsigned long msgno,unsigned long *length,
  72.   long flags);
  73. long mbx_text (MAILSTREAM *stream,unsigned long msgno,STRING *bs,long flags);
  74. void mbx_flag (MAILSTREAM *stream,char *sequence,char *flag,long flags);
  75. void mbx_flagmsg (MAILSTREAM *stream,MESSAGECACHE *elt);
  76. long mbx_ping (MAILSTREAM *stream);
  77. void mbx_check (MAILSTREAM *stream);
  78. void mbx_snarf (MAILSTREAM *stream);
  79. void mbx_expunge (MAILSTREAM *stream);
  80. long mbx_copy (MAILSTREAM *stream,char *sequence,char *mailbox,long options);
  81. long mbx_append (MAILSTREAM *stream,char *mailbox,char *flags,char *date,
  82.  STRING *message);
  83. char *mbx_file (char *dst,char *name);
  84. long mbx_parse (MAILSTREAM *stream);
  85. MESSAGECACHE *mbx_elt (MAILSTREAM *stream,unsigned long msgno,long expok);
  86. unsigned long mbx_read_flags (MAILSTREAM *stream,MESSAGECACHE *elt);
  87. void mbx_update_header (MAILSTREAM *stream);
  88. void mbx_update_status (MAILSTREAM *stream,unsigned long msgno,long flags);
  89. unsigned long mbx_hdrpos (MAILSTREAM *stream,unsigned long msgno,
  90.   unsigned long *size);