jehanne/sys/src/cmd/auth/secstore/SConn.h

51 lines
1.7 KiB
C

/*
* This file is part of the UCB release of Plan 9. It is subject to the license
* terms in the LICENSE file found in the top-level directory of this
* distribution and at http://akaros.cs.berkeley.edu/files/Plan9License. No
* part of the UCB release of Plan 9, including this file, may be copied,
* modified, propagated, or distributed except according to the terms contained
* in the LICENSE file.
*/
/* Portions of this file are Copyright (C) 2015-2018 Giacomo Tesio <giacomo@tesio.it>
* See /doc/license/gpl-2.0.txt for details about the licensing.
*/
/* Portions of this file are Copyright (C) 9front's team.
* See /doc/license/9front-mit for details about the licensing.
* See http://git.9front.org/plan9front/plan9front/HEAD/info.html for a list of authors.
*/
/* delimited, authenticated, encrypted connection */
enum {
Maxmsg = 4096, /* messages > Maxmsg bytes are truncated */
};
typedef struct SConn SConn;
struct SConn {
void *chan;
int secretlen;
int (*secret)(SConn*, uint8_t*, int);
int (*read)(SConn*, uint8_t*, int); /* <0 if error; errmess in buffer */
int (*write)(SConn*, uint8_t*, int);
void (*free)(SConn*); /* also closes file descriptor */
};
SConn *newSConn(int); /* arg is open file descriptor */
/*
* secret(s,b,dir) sets secret for digest, encrypt, using the secretlen
* bytes in b to form keys for the two directions;
* set dir=0 in client, dir=1 in server
*/
/* error convention: write !message in-band */
void writerr(SConn*, char*);
/*
* returns -1 upon error, with error message in buf
* call with buf of size Maxmsg+1
*/
int readstr(SConn*, char*);
void *emalloc(uint32_t); /* dies on failure; clears memory */
void *erealloc(void*, uint32_t);
char *estrdup(char*);