home *** CD-ROM | disk | FTP | other *** search
/ PC World 2001 February / PCWorld_2001-02_cd.bin / Software / Topware / Sambar / _setup.1 / sambar.h < prev    next >
C/C++ Source or Header  |  2000-12-17  |  24KB  |  876 lines
  1. /*
  2. ** SAMBAR.H
  3. **
  4. **      This is the public WIN32 header file for the Sambar 
  5. **        Server application.
  6. **
  7. **        Confidential Property of Tod Sambar
  8. **        (c) Copyright Tod Sambar 1996-1997
  9. **        All rights reserved.
  10. **
  11. **
  12. ** History:
  13. ** Chg#    Date    Description                                                Resp
  14. ** ----    -------    -------------------------------------------------------    ----
  15. **        10AUG96    Created                                                    sambar
  16. **        11APR97    Added server start/stop APIs                            sambar
  17. */
  18.  
  19. #if     !defined(__SAMBAR_H__)
  20. #define __SAMBAR_H__
  21.  
  22. /*
  23. ** Types
  24. */
  25. typedef int                            SA_RETCODE;
  26. typedef long                        SA_INT;
  27. typedef int                            SA_BOOL;
  28. typedef void                        SA_VOID;
  29. typedef unsigned char                SA_BYTE;
  30. typedef unsigned char                SA_CHAR;
  31.  
  32. #ifndef TEXT
  33. #define TEXT(x)                        (x)
  34. #endif
  35.  
  36. #ifndef MAX
  37. #define MAX(a,b)                    ((SA_INT)(a) > (SA_INT)(b) ? (a) : (b))
  38. #endif
  39.  
  40. #ifndef MIN
  41. #define MIN(a,b)                    ((SA_INT)(a) < (SA_INT)(b) ? (a) : (b))
  42. #endif
  43.  
  44. /*
  45. ** Public Structures
  46. */
  47. #define SA_CTX                        SA_VOID
  48. #define SA_CONN                        SA_VOID
  49. #define SA_PARAMS                    SA_VOID
  50. #define SA_REC                        SA_VOID
  51. #define SA_PROFILE                    SA_VOID
  52.  
  53.  
  54. /*
  55. ** Return Codes
  56. */
  57. #define SA_SUCCEED                    1
  58. #define SA_FAIL                        0
  59.  
  60.  
  61. /*
  62. ** Error Codes
  63. */
  64. #define SA_E_DOCFOLLOWS                (SA_INT)-1
  65. #define SA_E_INTERNALSYSTEM            (SA_INT)0
  66. #define SA_E_ALREADYLOGGEDIN        (SA_INT)1
  67. #define SA_E_BADCOOKIE                (SA_INT)2
  68. #define SA_E_INVALIDLOGIN            (SA_INT)3
  69. #define SA_E_MAXLOGINS                (SA_INT)4
  70. #define SA_E_ALREADYDEFINED            (SA_INT)5
  71. #define SA_E_INVALIDDATA            (SA_INT)6
  72. #define SA_E_NOTIMPLEMENTED            (SA_INT)7
  73. #define SA_E_FORBIDDEN                (SA_INT)8
  74. #define SA_E_NOTFOUND                (SA_INT)9
  75. #define SA_E_DUPLICATE                (SA_INT)10
  76. #define SA_E_DBOPFAILED                (SA_INT)11
  77. #define SA_E_BADGATEWAY                (SA_INT)12
  78. #define SA_E_REDIRECT                (SA_INT)13
  79. #define SA_E_USRDEF1                (SA_INT)14
  80. #define SA_E_USRDEF2                (SA_INT)15
  81. #define SA_E_USRDEF3                (SA_INT)16
  82. #define SA_E_USRDEF4                (SA_INT)17
  83. #define SA_E_USRDEF5                (SA_INT)18
  84. #define SA_E_USRDEF6                (SA_INT)19
  85. #define SA_E_USRDEF7                (SA_INT)20
  86. #define SA_E_USRDEF8                (SA_INT)21
  87. #define SA_E_USRDEF9                (SA_INT)22
  88. #define SA_E_USRDEF10                (SA_INT)23
  89. #define SA_E_USRDEF11                (SA_INT)24
  90. #define SA_E_USRDEF12                (SA_INT)25
  91. #define SA_E_USRDEF13                (SA_INT)26
  92. #define SA_E_USRDEF14                (SA_INT)27
  93. #define SA_E_USRDEF15                (SA_INT)28
  94. #define SA_E_USRDEF16                (SA_INT)29
  95. #define SA_E_USRDEF17                (SA_INT)30
  96. #define SA_E_USRDEF18                (SA_INT)31
  97. #define SA_E_USRDEF19                (SA_INT)32
  98. #define SA_E_USRDEF20                (SA_INT)33
  99. #define SA_E_TIMEOUT                (SA_INT)34
  100. #define SA_E_SHUTDOWN                (SA_INT)35
  101. #define SA_E_SERVERDOWN                (SA_INT)36
  102. #define SA_E_PAUSED                    (SA_INT)37
  103. #define SA_E_MAXCGIS                (SA_INT)38
  104. #define SA_E_INUSE                    (SA_INT)39
  105. #define SA_E_RESTART                (SA_INT)40
  106. #define SA_E_INTERRUPTED            (SA_INT)41
  107. #define SA_E_SSLONLY                (SA_INT)42
  108. #define SA_E_VERSIONCONTROL            (SA_INT)43
  109. #define SA_E_PERMANENTREDIRECT        (SA_INT)44
  110. #define SA_E_GONE                    (SA_INT)45
  111. #define SA_E_MAXELEMENTS            (SA_INT)46
  112. #define SA_E_LOGINWAIT                (SA_INT)47
  113.  
  114.  
  115. /*
  116. ** Actions
  117. */
  118. #define    SA_GET                        (SA_INT)1
  119. #define    SA_SET                        (SA_INT)2
  120. #define    SA_CLEAR                    (SA_INT)3
  121.  
  122. /*
  123. ** Misc Defines
  124. */
  125. #define SA_NULLTERM                    (SA_INT)-3
  126.  
  127. /*
  128. ** Context Properties
  129. */
  130. #define SA_CTXPROP_SYSADMIN            (SA_INT)1
  131. #define SA_CTXPROP_HOMEDIR            (SA_INT)2
  132. #define SA_CTXPROP_LOGDIR            (SA_INT)3
  133. #define SA_CTXPROP_DBCACHE            (SA_INT)4
  134. #define SA_CTXPROP_APPLICDIR        (SA_INT)5
  135. #define SA_CTXPROP_SERVERSW            (SA_INT)7
  136. #define SA_CTXPROP_SERVERPORT        (SA_INT)8
  137. #define SA_CTXPROP_SERVERNAME        (SA_INT)9
  138. #define SA_CTXPROP_SERVERIP            (SA_INT)10
  139. #define SA_CTXPROP_BUILDID            (SA_INT)11
  140. #define SA_CTXPROP_HTTPLOGFUNC        (SA_INT)12
  141. #define SA_CTXPROP_SECURITYMODEL    (SA_INT)13
  142. #define SA_CTXPROP_LICENSETYPE        (SA_INT)14
  143. #define SA_CTXPROP_AUTHLOGINS        (SA_INT)15
  144. #define SA_CTXPROP_NTAUTH            (SA_INT)16
  145.  
  146. /*
  147. ** Connection Properties
  148. */
  149. #define SA_CONNPROP_HOST            (SA_INT)1
  150. #define SA_CONNPROP_AGENT            (SA_INT)2
  151. #define SA_CONNPROP_REFERER            (SA_INT)3
  152. #define SA_CONNPROP_REQUEST            (SA_INT)4
  153. #define SA_CONNPROP_REQUESTMETHOD    (SA_INT)5
  154. #define SA_CONNPROP_USERNAME        (SA_INT)6
  155. #define SA_CONNPROP_NAME            (SA_INT)7
  156. #define SA_CONNPROP_PASSWORD        (SA_INT)8
  157. #define SA_CONNPROP_IPADDR            (SA_INT)9
  158. #define SA_CONNPROP_DOCSDIR            (SA_INT)10
  159. #define SA_CONNPROP_DOCSPATH        (SA_INT)11
  160. #define SA_CONNPROP_ROOTDIR            (SA_INT)12
  161. #define SA_CONNPROP_REQUESTHOST        (SA_INT)13
  162. #define SA_CONNPROP_PRIVS            (SA_INT)14
  163.  
  164. /*
  165. ** Scheduler Time Arguments
  166. */
  167. #define SA_SCHEDULETIME_TIMEOUT        (SA_INT)1        /* Every 2 minutes    */
  168. #define SA_SCHEDULETIME_HOURLY        (SA_INT)2        /* Every hour         */
  169. #define SA_SCHEDULETIME_DAILY        (SA_INT)3        /* Every day         */
  170. #define SA_SCHEDULETIME_WEEKLY        (SA_INT)4        /* Every week         */
  171. #define SA_SCHEDULETIME_MONTHLY        (SA_INT)5        /* Every month         */
  172.  
  173. /*
  174. ** Next Page Argument
  175. */
  176. #define SA_PAGE_ARG                    TEXT("RCpage")
  177. #define SA_REDIRECT_ARG                TEXT("RCredirect")
  178.  
  179. /*
  180. ** System Administrator & User Folders
  181. */
  182. #define SA_ADMIN_FOLDER                TEXT("sysadmin")
  183. #define SA_USER_FOLDER                TEXT("sysuser")
  184.  
  185. /*
  186. ** Default group
  187. */
  188. #define SA_DEFAULT_GROUP            TEXT("other")
  189.  
  190. /*
  191. ** RPC authorization types
  192. */
  193. #define SA_AUTHORIZATION_ALL        (SA_INT)0        /* All clients */
  194. #define SA_AUTHORIZATION_USER        (SA_INT)1        /* Logged in users only */
  195. #define SA_AUTHORIZATION_ADMIN        (SA_INT)2        /* Admin only */
  196. #define SA_AUTHORIZATION_SCRIPT        (SA_INT)3        /* Only inside scripts */
  197.  
  198. /*
  199. ** RPC parameters
  200. */
  201. typedef struct sa__rpcparam
  202. {
  203.     SA_CHAR            *name;                /* Parameter name */
  204.     SA_BOOL            required;            /* Required or optional param */
  205.     SA_CHAR            *descr;                /* Parameter description */
  206. } SA_RPCPARAM;
  207.  
  208. typedef struct sa__arg
  209. {
  210.     SA_CHAR            *value;                /* Parameter value */
  211.     struct sa__arg    *next;
  212. } SA_ARG;
  213.  
  214. /*
  215. ** Scalar parameters
  216. */
  217. typedef struct sa__scalararg
  218. {
  219.     SA_CHAR            *name;                /* Argument name */
  220.     SA_CHAR            *descr;                /* Argument description */
  221. } SA_SCALARARG;
  222.  
  223. /*
  224. ** Request-handler modules
  225. */
  226. typedef struct sa__request
  227. {
  228.         SA_INT        method;                /* SA_METHOD_* */
  229.         SA_CHAR        *uri;                /* URI requested. */
  230.         SA_INT         urilen; 
  231.         SA_CHAR        *path;                /* path to requested URI. */
  232.         SA_INT         pathlen; 
  233.         SA_CHAR     *args;
  234.         SA_INT         argslen; 
  235.         SA_CHAR     *content;
  236.         SA_INT         contentlen;
  237.         SA_CHAR     *pathinfo;
  238.         SA_INT         pathinfolen;
  239. } SA_REQUEST;
  240.  
  241. #define SA_METHOD_GET                (SA_INT)1
  242. #define SA_METHOD_POST                (SA_INT)2
  243. #define SA_METHOD_PUT                (SA_INT)3
  244. #define SA_METHOD_HEAD                (SA_INT)4
  245. #define SA_METHOD_PATCH                (SA_INT)5
  246. #define SA_METHOD_PROPFIND            (SA_INT)6
  247. #define SA_METHOD_PROPPATCH            (SA_INT)7
  248. #define SA_METHOD_DELETE            (SA_INT)8
  249. #define SA_METHOD_CONNECT            (SA_INT)9
  250. #define SA_METHOD_COPY                (SA_INT)10
  251. #define SA_METHOD_MKCOL                (SA_INT)11
  252. #define SA_METHOD_MOVE                (SA_INT)12
  253. #define SA_METHOD_OPTIONS            (SA_INT)13
  254. #define SA_METHOD_TRACE                (SA_INT)14
  255. #define SA_METHOD_LOCK                (SA_INT)15
  256. #define SA_METHOD_UNLOCK            (SA_INT)16
  257. #define SA_METHOD_SEARCH            (SA_INT)17
  258. #define SA_METHOD_CHECKOUT            (SA_INT)18
  259. #define SA_METHOD_UNCHECKOUT        (SA_INT)19
  260. #define SA_METHOD_CHECKIN            (SA_INT)20
  261. #define SA_METHOD_MKRESOURCE        (SA_INT)21
  262. #define SA_METHOD_REPORT            (SA_INT)22
  263.  
  264. /*
  265. ** HTTP Log callback structure
  266. */
  267. typedef struct sa__httplog
  268. {
  269.         SA_INT         size; 
  270.         SA_INT         status; 
  271.         SA_CHAR        *method;
  272.         SA_CHAR     *timestamp;
  273.         SA_CHAR     *request;
  274.         SA_CHAR     *args;
  275.         SA_CHAR     *vhost;
  276.         SA_CHAR     *user;                /* User IP Address */
  277.         SA_CHAR        *username;
  278.         SA_CHAR        *referer;
  279.         SA_CHAR        *agent;
  280.  
  281.         /* Include system statistics.                                    */
  282.         SA_INT         allconns;             /* Total network connections    */
  283.         SA_INT         httpconns;             /* # of HTTP connections        */
  284.         SA_INT         threads;             /* Total threads                */
  285. } SA_HTTPLOG;
  286.  
  287. /*
  288. ** Password Management
  289. */
  290. #define SA_PASSWD_FILE                TEXT("passwd")
  291. #define SA_MAX_NAME                    (SA_INT)64
  292. #define SA_MAX_VALUE                (SA_INT)1000
  293.  
  294. typedef struct sa__ftp
  295. {
  296.     SA_INT        privs;                                    /* FTP access */
  297.     SA_INT        ftpmax;                                    /* Maximum FTP MB */
  298.     SA_INT        dirlen;
  299.     SA_CHAR        dir[SA_MAX_NAME + 1];                    /* FTP root dir */
  300. } SA_FTP;
  301.  
  302. typedef struct sa__sip
  303. {
  304.     SA_INT        unused;                                    /* SIP access */
  305. } SA_SIP;
  306.  
  307. typedef struct sa__passwd
  308. {
  309.     SA_INT        privs;                                    /* Upload privs */
  310.     SA_INT        ftpmax;                                    /* FTP max upload */
  311.     SA_INT        dirlen;
  312.     SA_INT        namelen;
  313.     SA_INT        grouplen;
  314.     SA_INT        passwordlen;
  315.     SA_CHAR        name[SA_MAX_NAME + 1];                    /* Symbolic name */
  316.     SA_CHAR        group[SA_MAX_NAME + 1];
  317.     SA_CHAR        password[SA_MAX_NAME + 1];
  318.     SA_CHAR        dir[SA_MAX_NAME + 1];                    /* FTP dir */
  319.  
  320. } SA_PASSWD;
  321.  
  322. typedef struct sa__user
  323. {
  324.     SA_INT        grouplen;
  325.     SA_INT        usernamelen;
  326.     SA_CHAR        group[SA_MAX_NAME + 1];
  327.     SA_CHAR        username[SA_MAX_NAME + 1];
  328. } SA_USER;
  329.  
  330. typedef struct sa__group
  331. {
  332.     SA_INT        namelen;
  333.     SA_CHAR        name[SA_MAX_NAME + 1];
  334. } SA_GROUP;
  335.  
  336. /*
  337. ** FTP/Document Manager/HTTP PUT Priviledges
  338. */
  339. #define SA_PRIV_NOACCESS            (SA_INT)0
  340. #define SA_PRIV_READONLY            (SA_INT)1
  341. #define SA_PRIV_READWRITE            (SA_INT)2
  342.  
  343. /*
  344. ** Server Types
  345. */
  346. #define SA_SERVERTYPE_HTTP            (SA_INT)100
  347. #define SA_SERVERTYPE_HTTPPROXY        (SA_INT)101
  348. #define SA_SERVERTYPE_FTP            (SA_INT)102
  349. #define SA_SERVERTYPE_SMTPPROXY        (SA_INT)103
  350. #define SA_SERVERTYPE_POP3PROXY        (SA_INT)104
  351. #define SA_SERVERTYPE_IMAP4PROXY    (SA_INT)105
  352. #define SA_SERVERTYPE_BRIDGEPROXY    (SA_INT)106
  353. #define SA_SERVERTYPE_NNTPPROXY        (SA_INT)107
  354. #define SA_SERVERTYPE_FTPPROXY        (SA_INT)108
  355. #define SA_SERVERTYPE_SOCKSPROXY    (SA_INT)109
  356. #define SA_SERVERTYPE_TELNETPROXY    (SA_INT)110
  357. #define SA_SERVERTYPE_REALPROXY        (SA_INT)111
  358. #define SA_SERVERTYPE_SMTP            (SA_INT)112
  359. #define SA_SERVERTYPE_POP3            (SA_INT)113
  360. #define SA_SERVERTYPE_IMAP4            (SA_INT)114
  361. #define SA_SERVERTYPE_TELNET        (SA_INT)115
  362. #define SA_SERVERTYPE_DNS            (SA_INT)116
  363. #define SA_SERVERTYPE_SIP            (SA_INT)117
  364. #define SA_SERVERTYPE_DHCP            (SA_INT)118
  365. #define SA_SERVERTYPE_TFTP            (SA_INT)119
  366. #define SA_SERVERTYPE_TCPPROXY        (SA_INT)120
  367. #define SA_SERVERTYPE_UDPPROXY        (SA_INT)121
  368.  
  369. /*
  370. ** Record Flags
  371. */ 
  372. #define SA_REC_CREATE                (SA_INT)0x0001
  373. #define SA_REC_DELETE                (SA_INT)0x0002
  374.  
  375.  
  376. /*
  377. ** Sambar Server callbacks
  378. */
  379. typedef SA_RETCODE                (* SA_INITFUNC)(SA_CTX *ctx);
  380. typedef SA_RETCODE                (* SA_EXITFUNC)(SA_CTX *ctx);
  381. typedef SA_RETCODE                (* SA_LOGINFUNC)(SA_CTX *ctx, SA_CONN *conn, 
  382.                                     SA_CHAR *username, SA_INT usernamelen, 
  383.                                     SA_CHAR *password, SA_INT passwordlen, 
  384.                                     SA_INT *infop);
  385. typedef SA_RETCODE                (* SA_LOGOUTFUNC)(SA_CTX *ctx, SA_CONN *conn);
  386. typedef SA_RETCODE                (* SA_PROFILEFUNC)(SA_CTX *ctx, SA_CONN *conn,
  387.                                     SA_INT action, SA_CHAR *name, 
  388.                                     SA_INT namelen, SA_VOID *datap);
  389. typedef SA_RETCODE                (* SA_REQUESTFUNC)(SA_CTX *ctx, SA_CONN *conn,
  390.                                     SA_CHAR *uri, SA_INT urilen, 
  391.                                     SA_PARAMS *params, SA_INT *infop);
  392. typedef SA_RETCODE                (* SA_RPCFUNC)(SA_CTX *ctx, SA_CONN *conn,
  393.                                     SA_PARAMS *params, SA_INT *infop);
  394. typedef SA_RETCODE                (* SA_SCALARFUNC)(SA_CTX *ctx, SA_CONN *conn,
  395.                                     SA_ARG *args, SA_CHAR *value);
  396. typedef SA_RETCODE                (* SA_PROPFUNC)(SA_CTX *ctx, SA_VOID *argp, 
  397.                                     SA_CHAR *name, SA_CHAR *value);
  398. typedef SA_RETCODE                (* SA_FTPFUNC)(SA_CTX *ctx, SA_CHAR *name,
  399.                                     SA_INT namelen, SA_CHAR *password, 
  400.                                     SA_INT passwordlen, SA_FTP *ftpresp);
  401. typedef SA_RETCODE                (* SA_SIPFUNC)(SA_CTX *ctx, SA_CHAR *name,
  402.                                     SA_INT namelen, SA_CHAR *password, 
  403.                                     SA_INT passwordlen, SA_SIP *sipresp);
  404. typedef SA_RETCODE                (* SA_TELNETFUNC)(SA_CTX *ctx, SA_CHAR *name,
  405.                                     SA_INT namelen, SA_CHAR *password, 
  406.                                     SA_INT passwordlen);
  407. typedef SA_RETCODE                (* SA_MAILFUNC)(SA_CTX *ctx, SA_CHAR *name,
  408.                                     SA_INT namelen, SA_CHAR *password, 
  409.                                     SA_INT passwordlen);
  410. typedef SA_RETCODE                (* SA_NETCONNECTFUNC)(SA_CTX *ctx, 
  411.                                     SA_CHAR *ipaddr, SA_INT servertype);
  412. typedef SA_RETCODE                (* SA_HTTPPROXYFUNC)(SA_CTX *ctx, SA_CONN *conn,
  413.                                     SA_CHAR *host, SA_INT hostlen,
  414.                                     SA_CHAR *url, SA_INT urllen);
  415. typedef SA_RETCODE                (* SA_ENVTFUNC)(SA_CTX *ctx, SA_CONN *conn,
  416.                                     SA_CHAR *buffer, SA_INT buflen, 
  417.                                     SA_CHAR *data);
  418. typedef SA_RETCODE                (* SA_MODULEFUNC)(SA_CTX *ctx, SA_CONN *conn,
  419.                                     SA_REQUEST *request, SA_INT *infop);
  420. typedef SA_VOID                    (* SA_HTTPLOGFUNC)(SA_CTX *ctx, 
  421.                                     SA_HTTPLOG *httplog);
  422. typedef SA_RETCODE                (* SA_SCHEDULEFUNC)(SA_CTX *ctx, SA_CHAR *name,
  423.                                     SA_VOID *argp);
  424. typedef SA_VOID                    (* SA_RASFUNC)(SA_CTX *ctx, SA_CHAR *ip,
  425.                                     SA_CHAR *previp, SA_BOOL connected);
  426.  
  427.  
  428. /*
  429. ** Sambar Server Function Prototypes
  430. */
  431. #ifdef    WIN32
  432. #define SA_PUBLIC                __cdecl
  433. #define SA_EXPORT                __declspec(dllexport)
  434. #else    /* UNIX */
  435. #define SA_PUBLIC
  436. #define SA_EXPORT
  437. #endif
  438.  
  439. #if defined(__cplusplus)
  440. extern "C" {
  441. #endif    /* defined(__cplusplus) */
  442.  
  443. /*
  444. ** Sambar Server startup/shutdown
  445. */
  446. extern SA_RETCODE SA_EXPORT        sa_server(
  447.                                 SA_VOID            *hWnd
  448.                                 );
  449. extern SA_BOOL SA_EXPORT        sa_stopped(
  450.                                 void
  451.                                 );
  452. extern SA_RETCODE SA_EXPORT        sa_shutdown(
  453.                                 SA_BOOL            restart
  454.                                 );
  455. extern SA_RETCODE SA_EXPORT        sa_pause(
  456.                                 SA_BOOL            unpause
  457.                                 );
  458. /*
  459. ** General Functions
  460. */
  461.  
  462. extern SA_RETCODE SA_EXPORT        sa_cgi_exec(
  463.                                 SA_CTX            *ctx,
  464.                                 SA_CONN            *conn,
  465.                                 SA_REQUEST        *request
  466.                                 );
  467. extern SA_RETCODE SA_EXPORT        sa_wincgi_exec(
  468.                                 SA_CTX            *ctx,
  469.                                 SA_CONN            *conn,
  470.                                 SA_REQUEST        *request
  471.                                 );
  472. extern SA_RETCODE SA_EXPORT        sa_cmd_init(
  473.                                 SA_CTX            *ctx,
  474.                                 SA_CHAR            *name,
  475.                                 SA_RPCPARAM        *params,
  476.                                 SA_INT            numparams,
  477.                                 SA_INT            authorization,
  478.                                 SA_CHAR            *descr,
  479.                                 SA_RPCFUNC        funcp
  480.                                 );
  481. extern SA_RETCODE SA_EXPORT        sa_scalar_init(
  482.                                 SA_CTX            *ctx,
  483.                                 SA_CHAR            *name,
  484.                                 SA_SCALARARG    *args,
  485.                                 SA_INT            numargs,
  486.                                 SA_CHAR            *descr,
  487.                                 SA_SCALARFUNC    funcp
  488.                                 );
  489. extern SA_RETCODE SA_EXPORT        sa_props_load(
  490.                                 SA_CTX            *ctx,
  491.                                 SA_CHAR            *filename,
  492.                                 SA_CHAR            *section,
  493.                                 SA_VOID            *argp,
  494.                                 SA_PROPFUNC        funcp
  495.                                 );
  496. extern SA_RETCODE SA_EXPORT        sa_send_file(
  497.                                 SA_CONN            *conn,
  498.                                 SA_CHAR            *filename
  499.                                 );
  500. extern SA_RETCODE SA_EXPORT        sa_send_macro(
  501.                                 SA_CONN            *conn,
  502.                                 SA_CHAR            *macroname
  503.                                 );
  504. extern SA_RETCODE SA_EXPORT        sa_send_header(
  505.                                 SA_CONN            *conn,
  506.                                 SA_CHAR            *buffer,
  507.                                 SA_INT            buflen
  508.                                 );
  509. extern SA_RETCODE SA_EXPORT        sa_params(
  510.                                 SA_CTX            *ctx,
  511.                                 SA_CONN            *conn,
  512.                                 SA_PARAMS        **paramsp
  513.                                 );
  514. extern SA_RETCODE SA_EXPORT        sa_param(
  515.                                 SA_CTX            *ctx,
  516.                                 SA_PARAMS        *params,
  517.                                 SA_CHAR            *name,
  518.                                 SA_CHAR            **valuep,
  519.                                 SA_INT            *valuelenp
  520.                                 );
  521. extern SA_RETCODE SA_EXPORT        sa_param_set(
  522.                                 SA_CTX            *ctx,
  523.                                 SA_PARAMS        *params,
  524.                                 SA_CHAR            *name,
  525.                                 SA_CHAR            *value,
  526.                                 SA_INT            valuelen
  527.                                 );
  528. extern SA_RETCODE SA_EXPORT        sa_state_get(
  529.                                 SA_CTX            *ctx,
  530.                                 SA_CONN            *conn,
  531.                                 SA_CHAR            *name,
  532.                                 SA_CHAR            **valuep,
  533.                                 SA_INT            *valuelenp
  534.                                 );
  535. extern SA_RETCODE SA_EXPORT        sa_state_set(
  536.                                 SA_CTX            *ctx,
  537.                                 SA_CONN            *conn,
  538.                                 SA_CHAR            *name,
  539.                                 SA_CHAR            *value,
  540.                                 SA_INT            valuelen
  541.                                 );
  542. extern SA_VOID SA_EXPORT        sa_log(
  543.                                 SA_CTX            *ctx,
  544.                                 SA_CHAR            *buffer
  545.                                 );
  546. extern SA_VOID SA_EXPORT        sa_observe(
  547.                                 SA_CTX            *ctx,
  548.                                 SA_CHAR            *buffer
  549.                                 );
  550. extern SA_RETCODE SA_EXPORT        sa_get_macro(
  551.                                 SA_CTX            *ctx,
  552.                                 SA_CHAR            *macroname,
  553.                                 SA_CHAR            **macrop,
  554.                                 SA_INT            *macrolenp
  555.                                 );
  556. extern SA_RETCODE SA_EXPORT        sa_get_mime(
  557.                                 SA_CTX            *ctx,
  558.                                 SA_CHAR            *name,
  559.                                 SA_INT            namelen,
  560.                                 SA_CHAR            **mimetypep
  561.                                 );
  562. extern SA_RETCODE SA_EXPORT        sa_get_realpath(
  563.                                 SA_CTX            *ctx,
  564.                                 SA_CONN            *conn,
  565.                                 SA_CHAR            *name,
  566.                                 SA_INT            namelen,
  567.                                 SA_CHAR            *path,
  568.                                 SA_INT            maxpath
  569.                                 );
  570. extern SA_INT SA_EXPORT            sa_wildcmp(
  571.                                 SA_CTX            *ctx,
  572.                                 SA_CHAR            *wildstr,
  573.                                 SA_INT            wildstrlen,
  574.                                 SA_CHAR            *arg,
  575.                                 SA_INT            arglen
  576.                                 );
  577. extern SA_RETCODE SA_EXPORT        sa_schedule_task(
  578.                                 SA_CTX            *ctx,
  579.                                 SA_CHAR            *name,
  580.                                 SA_SCHEDULEFUNC    func,
  581.                                 SA_VOID            *argp,
  582.                                 SA_INT            when
  583.                                 );
  584.                                 
  585.  
  586. /*
  587. ** Mail Utility Functions
  588. */
  589. extern SA_RETCODE SA_EXPORT        sa_smtpmail(
  590.                                 SA_CTX            *ctx,
  591.                                 SA_CONN            *conn,
  592.                                 SA_CHAR            *from,
  593.                                 SA_CHAR            *tolist,
  594.                                 SA_CHAR            *cclist,
  595.                                 SA_CHAR            *bcclist,
  596.                                 SA_CHAR            *subject,
  597.                                 SA_CHAR            *message,
  598.                                 SA_CHAR            *attachment
  599.                                 );
  600.  
  601. extern SA_RETCODE SA_EXPORT        sa_mbox_create(
  602.                                 SA_CTX            *ctx,
  603.                                 SA_CHAR            *user
  604.                                 );
  605. extern SA_RETCODE SA_EXPORT        sa_mbox_delete(
  606.                                 SA_CTX            *ctx,
  607.                                 SA_CHAR            *user
  608.                                 );
  609. extern SA_BOOL SA_EXPORT        sa_mbox_exists(
  610.                                 SA_CTX            *ctx,
  611.                                 SA_CHAR            *user
  612.                                 );
  613.  
  614. /*
  615. ** Context Functions
  616. */
  617. extern SA_RETCODE SA_EXPORT        sa_ctx_global(
  618.                                 SA_CTX            **ctxp
  619.                                 );
  620. extern SA_RETCODE SA_EXPORT        sa_ctx_key(
  621.                                 SA_CTX            *ctx,
  622.                                 SA_INT            action,
  623.                                 SA_CHAR            *key,
  624.                                 SA_VOID            **valuep
  625.                                 );
  626. extern SA_RETCODE SA_EXPORT        sa_ctx_props(
  627.                                 SA_CTX            *ctx,
  628.                                 SA_INT            action,
  629.                                 SA_INT            property,
  630.                                 SA_BYTE            *buffer,
  631.                                 SA_INT            buflen,
  632.                                 SA_INT            *outlenp
  633.                                 );
  634. extern SA_RETCODE SA_EXPORT        sa_envt_prop(
  635.                                 SA_CTX            *ctx,
  636.                                 SA_CONN            *conn,
  637.                                 SA_BYTE            *prop,
  638.                                 SA_INT            proplen,
  639.                                 SA_CHAR            *buffer
  640.                                 );
  641.  
  642. /*
  643. ** Connection Functions
  644. */
  645. extern SA_RETCODE SA_EXPORT        sa_conn_key(
  646.                                 SA_CONN            *conn,
  647.                                 SA_INT            action,
  648.                                 SA_CHAR            *key,
  649.                                 SA_VOID            **valuep
  650.                                 );
  651. extern SA_RETCODE SA_EXPORT        sa_conn_props(
  652.                                 SA_CONN            *conn,
  653.                                 SA_INT            action,
  654.                                 SA_INT            property,
  655.                                 SA_BYTE            *buffer,
  656.                                 SA_INT            buflen,
  657.                                 SA_INT            *outlenp
  658.                                 );
  659. extern SA_RETCODE SA_EXPORT        sa_conn_send(
  660.                                 SA_CONN            *conn,
  661.                                 SA_CHAR            *buffer,
  662.                                 SA_INT            buflen
  663.                                 );
  664. extern SA_RETCODE SA_EXPORT        sa_conn_flush(
  665.                                 SA_CONN            *conn
  666.                                 );
  667. extern SA_RETCODE SA_EXPORT        sa_conn_redirect(
  668.                                 SA_CONN            *conn,
  669.                                 SA_CHAR            *location,
  670.                                 SA_CHAR            *buffer,
  671.                                 SA_INT            buflen
  672.                                 );
  673. extern SA_RETCODE SA_EXPORT        sa_conn_login(
  674.                                 SA_CONN            *conn,
  675.                                 SA_CHAR            *user,
  676.                                 SA_INT            userlen,
  677.                                 SA_CHAR            *password,
  678.                                 SA_INT            passwordlen,
  679.                                 SA_INT            *infop
  680.                                 );
  681. extern SA_RETCODE SA_EXPORT        sa_conn_maptourl(
  682.                                 SA_CONN            *conn,
  683.                                 SA_CHAR            *path,
  684.                                 SA_CHAR            *buffer
  685.                                 );
  686.  
  687. /*
  688. ** User/Password Management Routines
  689. */
  690. extern SA_RETCODE SA_EXPORT        sa_passwd_verify(
  691.                                 SA_CTX            *ctx,
  692.                                 SA_CHAR            *username,
  693.                                 SA_INT            usernamelen,
  694.                                 SA_CHAR            *password,
  695.                                 SA_INT            passwordlen,
  696.                                 SA_BOOL            *statusp
  697.                                 );
  698. extern SA_RETCODE SA_EXPORT        sa_passwd_lookup(
  699.                                 SA_CTX            *ctx,
  700.                                 SA_CHAR            *username,
  701.                                 SA_INT            usernamelen,
  702.                                 SA_PASSWD        *passwd
  703.                                 );
  704. extern SA_RETCODE SA_EXPORT        sa_passwd_add(
  705.                                 SA_CTX            *ctx,
  706.                                 SA_CHAR            *username,
  707.                                 SA_INT            usernamelen,
  708.                                 SA_PASSWD        *passwd
  709.                                 );
  710. extern SA_RETCODE SA_EXPORT        sa_passwd_update(
  711.                                 SA_CTX            *ctx,
  712.                                 SA_CHAR            *username,
  713.                                 SA_INT            usernamelen,
  714.                                 SA_PASSWD        *passwd
  715.                                 );
  716. extern SA_RETCODE SA_EXPORT        sa_passwd_delete(
  717.                                 SA_CTX            *ctx,
  718.                                 SA_CHAR            *username,
  719.                                 SA_INT            usernamelen
  720.                                 );
  721. extern SA_RETCODE SA_EXPORT        sa_passwd_list(
  722.                                 SA_CTX            *ctx,
  723.                                 SA_USER            *users,
  724.                                 SA_INT            numusers,
  725.                                 SA_INT            *countp
  726.                                 );
  727.  
  728. /*
  729. ** Group Management Routines
  730. */
  731. extern SA_RETCODE SA_EXPORT        sa_group_add(
  732.                                 SA_CTX            *ctx,
  733.                                 SA_CHAR            *name,
  734.                                 SA_INT            namelen
  735.                                 );
  736. extern SA_RETCODE SA_EXPORT        sa_group_delete(
  737.                                 SA_CTX            *ctx,
  738.                                 SA_CHAR            *name,
  739.                                 SA_INT            namelen
  740.                                 );
  741. extern SA_RETCODE SA_EXPORT        sa_group_list(
  742.                                 SA_CTX            *ctx,
  743.                                 SA_GROUP        *groups,
  744.                                 SA_INT            numgroups,
  745.                                 SA_INT            *countp
  746.                                 );
  747.  
  748. /*
  749. ** Profile Functions
  750. */
  751. extern SA_RETCODE SA_EXPORT        sa_profile_init(
  752.                                 SA_CTX            *ctx,
  753.                                 SA_CHAR            *username,
  754.                                 SA_INT            usernamelen,
  755.                                 SA_PROFILE        **profilep
  756.                                 );
  757. extern SA_RETCODE SA_EXPORT        sa_profile_exit(
  758.                                 SA_CTX            *ctx,
  759.                                 SA_PROFILE        *profile
  760.                                 );
  761. extern SA_RETCODE SA_EXPORT        sa_profile_save(
  762.                                 SA_CTX            *ctx,
  763.                                 SA_PROFILE        *profile
  764.                                 );
  765. extern SA_RETCODE SA_EXPORT        sa_profile_get(
  766.                                 SA_CTX            *ctx,
  767.                                 SA_PROFILE        *profile,
  768.                                 SA_CHAR            *name,
  769.                                 SA_INT            namelen,
  770.                                 SA_CHAR            **datap
  771.                                 );
  772. extern SA_RETCODE SA_EXPORT        sa_profile_set(
  773.                                 SA_CTX            *ctx,
  774.                                 SA_PROFILE        *profile,
  775.                                 SA_CHAR            *name,
  776.                                 SA_INT            namelen,
  777.                                 SA_CHAR            *value
  778.                                 );
  779.  
  780.  
  781. /*
  782. ** Search Functions
  783. */
  784. extern SA_RETCODE SA_EXPORT        sa_search_add(
  785.                                 SA_CTX            *ctx,
  786.                                 SA_CHAR            *indexname,
  787.                                 SA_CHAR            *title,
  788.                                 SA_CHAR            *url,
  789.                                 SA_CHAR            *data,
  790.                                 SA_INT            datalen
  791.                                 );
  792.  
  793. /*
  794. ** RAS Functions
  795. */
  796. extern SA_RETCODE SA_EXPORT        sa_ras_disconnect(
  797.                                 SA_CTX            *ctx,
  798.                                 SA_BOOL            *activep
  799.                                 );
  800.  
  801. /*
  802. ** Record Functions
  803. */
  804. extern SA_RETCODE SA_EXPORT        sa_rec_init(
  805.                                 SA_CTX            *ctx,
  806.                                 SA_CHAR            *filename,
  807.                                 SA_INT            flags,
  808.                                 SA_INT            reclen,
  809.                                 SA_REC            **recp
  810.                                 );
  811. extern SA_RETCODE SA_EXPORT        sa_rec_exit(
  812.                                 SA_REC            *rec,
  813.                                 SA_INT            flags
  814.                                 );
  815. extern SA_RETCODE SA_EXPORT        sa_rec_insert(
  816.                                 SA_REC            *rec,
  817.                                 SA_BYTE            *data,
  818.                                 SA_INT            *idp
  819.                                 );
  820. extern SA_RETCODE SA_EXPORT        sa_rec_update(
  821.                                 SA_REC            *rec,
  822.                                 SA_INT            id,
  823.                                 SA_BYTE            *data
  824.                                 );
  825. extern SA_RETCODE SA_EXPORT        sa_rec_delete(
  826.                                 SA_REC            *rec,
  827.                                 SA_INT            id
  828.                                 );
  829. extern SA_RETCODE SA_EXPORT        sa_rec_fetch(
  830.                                 SA_REC            *rec,
  831.                                 SA_INT            id,
  832.                                 SA_BYTE            *data
  833.                                 );
  834. extern SA_RETCODE SA_EXPORT        sa_rec_next(
  835.                                 SA_REC            *rec,
  836.                                 SA_INT            lastid,
  837.                                 SA_BYTE            *data,
  838.                                 SA_INT            *idp
  839.                                 );
  840.  
  841. /*
  842. ** General Utilities
  843. */
  844. extern SA_INT SA_EXPORT            sa_dirsize(
  845.                                 SA_CHAR            *dirpath
  846.                                 );
  847. extern SA_INT SA_EXPORT            sa_dirfiles(
  848.                                 SA_CHAR            *dirpath
  849.                                 );
  850. extern SA_RETCODE SA_EXPORT        sa_gzip(
  851.                                 SA_CHAR            *filename,
  852.                                 SA_CHAR            *ext
  853.                                 );
  854. extern SA_RETCODE SA_EXPORT        sa_gunzip(
  855.                                 SA_CHAR            *filename,
  856.                                 SA_CHAR            *ext
  857.                                 );
  858. extern SA_RETCODE SA_EXPORT        sa_compress(
  859.                                 SA_BYTE            *in,
  860.                                 SA_INT            inlen,
  861.                                 SA_BYTE            *out,
  862.                                 SA_INT            *outlenp
  863.                                 );
  864. extern SA_RETCODE SA_EXPORT        sa_uncompress(
  865.                                 SA_BYTE            *in,
  866.                                 SA_INT            inlen,
  867.                                 SA_BYTE            *out,
  868.                                 SA_INT            *outlenp
  869.                                 );
  870.  
  871. #if defined(__cplusplus)
  872. }
  873. #endif    /* defined(__cplusplus) */
  874.  
  875. #endif /* __SAMBAR_H__ */
  876.