mppe.h

Go to the documentation of this file.

/*
 * mppe.h - Definitions for MPPE
 *
 * Copyright (c) 2008 Paul Mackerras. All rights reserved.
 *
 * Redistribution and use in source and binary forms, with or without
 * modification, are permitted provided that the following conditions
 * are met:
 *
 * 1. Redistributions of source code must retain the above copyright
 *    notice, this list of conditions and the following disclaimer.
 *
 * 2. Redistributions in binary form must reproduce the above copyright
 *    notice, this list of conditions and the following disclaimer in
 *    the documentation and/or other materials provided with the
 *    distribution.
 *
 * 3. The name(s) of the authors of this software must not be used to
 *    endorse or promote products derived from this software without
 *    prior written permission.
 *
 * 4. Redistributions of any form whatsoever must retain the following
 *    acknowledgment:
 *    "This product includes software developed by Paul Mackerras
 *     <paulus@samba.org>".
 *
 * THE AUTHORS OF THIS SOFTWARE DISCLAIM ALL WARRANTIES WITH REGARD TO
 * THIS SOFTWARE, INCLUDING ALL IMPLIED WARRANTIES OF MERCHANTABILITY
 * AND FITNESS, IN NO EVENT SHALL THE AUTHORS BE LIABLE FOR ANY
 * SPECIAL, INDIRECT OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
 * WHATSOEVER RESULTING FROM LOSS OF USE, DATA OR PROFITS, WHETHER IN
 * AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
 * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
 */
 
#include "netif/ppp/ppp_opts.h"
#if PPP_SUPPORT && MPPE_SUPPORT  /* don't build if not configured for use in lwipopts.h */
 
#ifndef MPPE_H
#define MPPE_H
 
#include "netif/ppp/pppcrypt.h"
 
#ifdef __cplusplus
extern "C" {
#endif
 
#define MPPE_PAD    4 /* MPPE growth per frame */
#define MPPE_MAX_KEY_LEN  16  /* largest key length (128-bit) */
 
/* option bits for ccp_options.mppe */
#define MPPE_OPT_40   0x01  /* 40 bit */
#define MPPE_OPT_128    0x02  /* 128 bit */
#define MPPE_OPT_STATEFUL 0x04  /* stateful mode */
/* unsupported opts */
#define MPPE_OPT_56   0x08  /* 56 bit */
#define MPPE_OPT_MPPC   0x10  /* MPPC compression */
#define MPPE_OPT_D    0x20  /* Unknown */
#define MPPE_OPT_UNSUPPORTED (MPPE_OPT_56|MPPE_OPT_MPPC|MPPE_OPT_D)
#define MPPE_OPT_UNKNOWN  0x40  /* Bits !defined in RFC 3078 were set */
 
/*
 * This is not nice ... the alternative is a bitfield struct though.
 * And unfortunately, we cannot share the same bits for the option
 * names above since C and H are the same bit.  We could do a u_int32
 * but then we have to do a lwip_htonl() all the time and/or we still need
 * to know which octet is which.
 */
#define MPPE_C_BIT    0x01  /* MPPC */
#define MPPE_D_BIT    0x10  /* Obsolete, usage unknown */
#define MPPE_L_BIT    0x20  /* 40-bit */
#define MPPE_S_BIT    0x40  /* 128-bit */
#define MPPE_M_BIT    0x80  /* 56-bit, not supported */
#define MPPE_H_BIT    0x01  /* Stateless (in a different byte) */
 
/* Does not include H bit; used for least significant octet only. */
#define MPPE_ALL_BITS (MPPE_D_BIT|MPPE_L_BIT|MPPE_S_BIT|MPPE_M_BIT|MPPE_H_BIT)
 
/* Build a CI from mppe opts (see RFC 3078) */
#define MPPE_OPTS_TO_CI(opts, ci)   \
    do {          \
  u_char *ptr = ci; /* u_char[4] */ \
            \
  /* H bit */       \
  if (opts & MPPE_OPT_STATEFUL)   \
      *ptr++ = 0x0;     \
  else          \
      *ptr++ = MPPE_H_BIT;    \
  *ptr++ = 0;       \
  *ptr++ = 0;       \
            \
  /* S,L bits */        \
  *ptr = 0;       \
  if (opts & MPPE_OPT_128)    \
      *ptr |= MPPE_S_BIT;     \
  if (opts & MPPE_OPT_40)     \
      *ptr |= MPPE_L_BIT;     \
  /* M,D,C bits not supported */    \
    } while (/* CONSTCOND */ 0)
 
/* The reverse of the above */
#define MPPE_CI_TO_OPTS(ci, opts)   \
    do {          \
  const u_char *ptr = ci; /* u_char[4] */ \
            \
  opts = 0;       \
            \
  /* H bit */       \
  if (!(ptr[0] & MPPE_H_BIT))   \
      opts |= MPPE_OPT_STATEFUL;    \
            \
  /* S,L bits */        \
  if (ptr[3] & MPPE_S_BIT)    \
      opts |= MPPE_OPT_128;   \
  if (ptr[3] & MPPE_L_BIT)    \
      opts |= MPPE_OPT_40;    \
            \
  /* M,D,C bits */      \
  if (ptr[3] & MPPE_M_BIT)    \
      opts |= MPPE_OPT_56;    \
  if (ptr[3] & MPPE_D_BIT)    \
      opts |= MPPE_OPT_D;     \
  if (ptr[3] & MPPE_C_BIT)    \
      opts |= MPPE_OPT_MPPC;    \
            \
  /* Other bits */      \
  if (ptr[0] & ~MPPE_H_BIT)   \
      opts |= MPPE_OPT_UNKNOWN;   \
  if (ptr[1] || ptr[2])     \
      opts |= MPPE_OPT_UNKNOWN;   \
  if (ptr[3] & ~MPPE_ALL_BITS)    \
      opts |= MPPE_OPT_UNKNOWN;   \
    } while (/* CONSTCOND */ 0)
 
/* Shared MPPE padding between MSCHAP and MPPE */
#define SHA1_PAD_SIZE 40
 
static const u8_t mppe_sha1_pad1[SHA1_PAD_SIZE] = {
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00,
  0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00, 0x00
};
static const u8_t mppe_sha1_pad2[SHA1_PAD_SIZE] = {
  0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2,
  0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2,
  0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2,
  0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2, 0xf2
};
 
/*
 * State for an MPPE (de)compressor.
 */
typedef struct ppp_mppe_state {
  lwip_arc4_context arc4;
  u8_t master_key[MPPE_MAX_KEY_LEN];
  u8_t session_key[MPPE_MAX_KEY_LEN];
  u8_t keylen;                /* key length in bytes */
  /* NB: 128-bit == 16, 40-bit == 8!
   * If we want to support 56-bit, the unit has to change to bits
   */
  u8_t bits;                  /* MPPE control bits */
  u16_t ccount;               /* 12-bit coherency count (seqno)  */
  u16_t sanity_errors;        /* take down LCP if too many */
  unsigned int stateful  :1;  /* stateful mode flag */
  unsigned int discard   :1;  /* stateful mode packet loss flag */
} ppp_mppe_state;
 
void mppe_set_key(ppp_pcb *pcb, ppp_mppe_state *state, u8_t *key);
void mppe_init(ppp_pcb *pcb, ppp_mppe_state *state, u8_t options);
void mppe_comp_reset(ppp_pcb *pcb, ppp_mppe_state *state);
err_t mppe_compress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb, u16_t protocol);
void mppe_decomp_reset(ppp_pcb *pcb, ppp_mppe_state *state);
err_t mppe_decompress(ppp_pcb *pcb, ppp_mppe_state *state, struct pbuf **pb);
 
#ifdef __cplusplus
}
#endif
 
#endif /* MPPE_H */
#endif /* PPP_SUPPORT && MPPE_SUPPORT */