Annotation of qemu/roms/ipxe/src/crypto/chap.c, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (C) 2006 Michael Brown <[email protected]>.
                      3:  *
                      4:  * This program is free software; you can redistribute it and/or
                      5:  * modify it under the terms of the GNU General Public License as
                      6:  * published by the Free Software Foundation; either version 2 of the
                      7:  * License, or any later version.
                      8:  *
                      9:  * This program is distributed in the hope that it will be useful, but
                     10:  * WITHOUT ANY WARRANTY; without even the implied warranty of
                     11:  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
                     12:  * General Public License for more details.
                     13:  *
                     14:  * You should have received a copy of the GNU General Public License
                     15:  * along with this program; if not, write to the Free Software
                     16:  * Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
                     17:  */
                     18: 
                     19: FILE_LICENCE ( GPL2_OR_LATER );
                     20: 
                     21: #include <stddef.h>
                     22: #include <stdlib.h>
                     23: #include <string.h>
                     24: #include <errno.h>
                     25: #include <assert.h>
                     26: #include <ipxe/crypto.h>
                     27: #include <ipxe/chap.h>
                     28: 
                     29: /** @file
                     30:  *
                     31:  * CHAP protocol
                     32:  *
                     33:  */
                     34: 
                     35: /**
                     36:  * Initialise CHAP challenge/response
                     37:  *
                     38:  * @v chap             CHAP challenge/response
                     39:  * @v digest           Digest algorithm to use
                     40:  * @ret rc             Return status code
                     41:  *
                     42:  * Initialises a CHAP challenge/response structure.  This routine
                     43:  * allocates memory, and so may fail.  The allocated memory must
                     44:  * eventually be freed by a call to chap_finish().
                     45:  */
                     46: int chap_init ( struct chap_response *chap,
                     47:                struct digest_algorithm *digest ) {
                     48:        size_t state_len;
                     49:        void *state;
                     50: 
                     51:        assert ( chap->digest == NULL );
                     52:        assert ( chap->digest_context == NULL );
                     53:        assert ( chap->response == NULL );
                     54: 
                     55:        DBG ( "CHAP %p initialising with %s digest\n", chap, digest->name );
                     56: 
                     57:        state_len = ( digest->ctxsize + digest->digestsize );
                     58:        state = malloc ( state_len );
                     59:        if ( ! state ) {
                     60:                DBG ( "CHAP %p could not allocate %zd bytes for state\n",
                     61:                      chap, state_len );
                     62:                return -ENOMEM;
                     63:        }
                     64:        
                     65:        chap->digest = digest;
                     66:        chap->digest_context = state;
                     67:        chap->response = ( state + digest->ctxsize );
                     68:        chap->response_len = digest->digestsize;
                     69:        digest_init ( chap->digest, chap->digest_context );
                     70:        return 0;
                     71: }
                     72: 
                     73: /**
                     74:  * Add data to the CHAP challenge
                     75:  *
                     76:  * @v chap             CHAP response
                     77:  * @v data             Data to add
                     78:  * @v len              Length of data to add
                     79:  */
                     80: void chap_update ( struct chap_response *chap, const void *data,
                     81:                   size_t len ) {
                     82:        assert ( chap->digest != NULL );
                     83:        assert ( chap->digest_context != NULL );
                     84: 
                     85:        if ( ! chap->digest )
                     86:                return;
                     87: 
                     88:        digest_update ( chap->digest, chap->digest_context, data, len );
                     89: }
                     90: 
                     91: /**
                     92:  * Respond to the CHAP challenge
                     93:  *
                     94:  * @v chap             CHAP response
                     95:  *
                     96:  * Calculates the final CHAP response value, and places it in @c
                     97:  * chap->response, with a length of @c chap->response_len.
                     98:  */
                     99: void chap_respond ( struct chap_response *chap ) {
                    100:        assert ( chap->digest != NULL );
                    101:        assert ( chap->digest_context != NULL );
                    102:        assert ( chap->response != NULL );
                    103: 
                    104:        DBG ( "CHAP %p responding to challenge\n", chap );
                    105: 
                    106:        if ( ! chap->digest )
                    107:                return;
                    108: 
                    109:        digest_final ( chap->digest, chap->digest_context, chap->response );
                    110: }
                    111: 
                    112: /**
                    113:  * Free resources used by a CHAP response
                    114:  *
                    115:  * @v chap             CHAP response
                    116:  */
                    117: void chap_finish ( struct chap_response *chap ) {
                    118:        void *state = chap->digest_context;
                    119: 
                    120:        DBG ( "CHAP %p finished\n", chap );
                    121: 
                    122:        free ( state );
                    123:        memset ( chap, 0, sizeof ( *chap ) );
                    124: }

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.