2 * BSD compression module
4 * Patched version for ISDN syncPPP written 1997/1998 by Michael Hipp
5 * The whole module is now SKB based.
10 * Update: The Berkeley copyright was changed, and the change
11 * is retroactive to all "true" BSD software (ie everything
12 * from UCB as opposed to other peoples code that just carried
13 * the same license). The new copyright doesn't clash with the
14 * GPL, so the module-only restriction has been removed..
18 * Original copyright notice:
20 * Copyright (c) 1985, 1986 The Regents of the University of California.
21 * All rights reserved.
23 * This code is derived from software contributed to Berkeley by
24 * James A. Woods, derived from original work by Spencer Thomas
27 * Redistribution and use in source and binary forms, with or without
28 * modification, are permitted provided that the following conditions
30 * 1. Redistributions of source code must retain the above copyright
31 * notice, this list of conditions and the following disclaimer.
32 * 2. Redistributions in binary form must reproduce the above copyright
33 * notice, this list of conditions and the following disclaimer in the
34 * documentation and/or other materials provided with the distribution.
35 * 3. All advertising materials mentioning features or use of this software
36 * must display the following acknowledgement:
37 * This product includes software developed by the University of
38 * California, Berkeley and its contributors.
39 * 4. Neither the name of the University nor the names of its contributors
40 * may be used to endorse or promote products derived from this software
41 * without specific prior written permission.
43 * THIS SOFTWARE IS PROVIDED BY THE REGENTS AND CONTRIBUTORS ``AS IS'' AND
44 * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
45 * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
46 * ARE DISCLAIMED. IN NO EVENT SHALL THE REGENTS OR CONTRIBUTORS BE LIABLE
47 * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
48 * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
49 * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
50 * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
51 * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
52 * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
56 #include <linux/module.h>
57 #include <linux/init.h>
58 #include <linux/kernel.h>
59 #include <linux/types.h>
60 #include <linux/fcntl.h>
61 #include <linux/interrupt.h>
62 #include <linux/ptrace.h>
63 #include <linux/ioport.h>
65 #include <linux/slab.h>
66 #include <linux/tty.h>
67 #include <linux/errno.h>
68 #include <linux/string.h> /* used in new tty drivers */
69 #include <linux/signal.h> /* used in new tty drivers */
70 #include <linux/bitops.h>
72 #include <asm/system.h>
73 #include <asm/byteorder.h>
74 #include <asm/types.h>
78 #include <linux/if_ether.h>
79 #include <linux/netdevice.h>
80 #include <linux/skbuff.h>
81 #include <linux/inet.h>
82 #include <linux/ioctl.h>
83 #include <linux/vmalloc.h>
85 #include <linux/ppp_defs.h>
87 #include <linux/isdn.h>
88 #include <linux/isdn_ppp.h>
90 #include <linux/tcp.h>
91 #include <linux/if_arp.h>
92 #include <linux/ppp-comp.h>
96 MODULE_DESCRIPTION("ISDN4Linux: BSD Compression for PPP over ISDN");
97 MODULE_LICENSE("Dual BSD/GPL");
99 #define BSD_VERSION(x) ((x) >> 5)
100 #define BSD_NBITS(x) ((x) & 0x1F)
102 #define BSD_CURRENT_VERSION 1
107 * A dictionary for doing BSD compress.
112 u16 codem1; /* output of hash table -1 */
113 u16 cptr; /* map code to hash table entry */
117 int totlen; /* length of this structure */
118 unsigned int hsize; /* size of the hash table */
119 unsigned char hshift; /* used in hash function */
120 unsigned char n_bits; /* current bits/code */
121 unsigned char maxbits; /* maximum bits/code */
122 unsigned char debug; /* non-zero if debug desired */
123 unsigned char unit; /* ppp unit number */
124 u16 seqno; /* sequence # of next packet */
125 unsigned int mru; /* size of receive (decompress) bufr */
126 unsigned int maxmaxcode; /* largest valid code */
127 unsigned int max_ent; /* largest code in use */
128 unsigned int in_count; /* uncompressed bytes, aged */
129 unsigned int bytes_out; /* compressed bytes, aged */
130 unsigned int ratio; /* recent compression ratio */
131 unsigned int checkpoint; /* when to next check the ratio */
132 unsigned int clear_count; /* times dictionary cleared */
133 unsigned int incomp_count; /* incompressible packets */
134 unsigned int incomp_bytes; /* incompressible bytes */
135 unsigned int uncomp_count; /* uncompressed packets */
136 unsigned int uncomp_bytes; /* uncompressed bytes */
137 unsigned int comp_count; /* compressed packets */
138 unsigned int comp_bytes; /* compressed bytes */
139 unsigned short *lens; /* array of lengths of codes */
140 struct bsd_dict *dict; /* dictionary */
144 #define BSD_OVHD 2 /* BSD compress overhead/packet */
145 #define MIN_BSD_BITS 9
146 #define BSD_INIT_BITS MIN_BSD_BITS
147 #define MAX_BSD_BITS 15
150 * the next two codes should not be changed lightly, as they must not
151 * lie within the contiguous general code space.
153 #define CLEAR 256 /* table clear output code */
154 #define FIRST 257 /* first free entry */
157 #define MAXCODE(b) ((1 << (b)) - 1)
158 #define BADCODEM1 MAXCODE(MAX_BSD_BITS);
160 #define BSD_HASH(prefix,suffix,hshift) ((((unsigned long)(suffix))<<(hshift)) \
161 ^ (unsigned long)(prefix))
162 #define BSD_KEY(prefix,suffix) ((((unsigned long)(suffix)) << 16) \
163 + (unsigned long)(prefix))
165 #define CHECK_GAP 10000 /* Ratio check interval */
167 #define RATIO_SCALE_LOG 8
168 #define RATIO_SCALE (1<<RATIO_SCALE_LOG)
169 #define RATIO_MAX (0x7fffffff>>RATIO_SCALE_LOG)
172 * clear the dictionary
175 static void bsd_clear(struct bsd_db *db)
178 db->max_ent = FIRST-1;
179 db->n_bits = BSD_INIT_BITS;
182 db->incomp_count = 0;
184 db->checkpoint = CHECK_GAP;
188 * If the dictionary is full, then see if it is time to reset it.
190 * Compute the compression ratio using fixed-point arithmetic
191 * with 8 fractional bits.
193 * Since we have an infinite stream instead of a single file,
194 * watch only the local compression ratio.
196 * Since both peers must reset the dictionary at the same time even in
197 * the absence of CLEAR codes (while packets are incompressible), they
198 * must compute the same ratio.
200 static int bsd_check (struct bsd_db *db) /* 1=output CLEAR */
202 unsigned int new_ratio;
204 if (db->in_count >= db->checkpoint)
206 /* age the ratio by limiting the size of the counts */
207 if (db->in_count >= RATIO_MAX || db->bytes_out >= RATIO_MAX)
209 db->in_count -= (db->in_count >> 2);
210 db->bytes_out -= (db->bytes_out >> 2);
213 db->checkpoint = db->in_count + CHECK_GAP;
215 if (db->max_ent >= db->maxmaxcode)
217 /* Reset the dictionary only if the ratio is worse,
218 * or if it looks as if it has been poisoned
219 * by incompressible data.
221 * This does not overflow, because
222 * db->in_count <= RATIO_MAX.
225 new_ratio = db->in_count << RATIO_SCALE_LOG;
226 if (db->bytes_out != 0)
228 new_ratio /= db->bytes_out;
231 if (new_ratio < db->ratio || new_ratio < 1 * RATIO_SCALE)
236 db->ratio = new_ratio;
246 static void bsd_stats (void *state, struct compstat *stats)
248 struct bsd_db *db = (struct bsd_db *) state;
250 stats->unc_bytes = db->uncomp_bytes;
251 stats->unc_packets = db->uncomp_count;
252 stats->comp_bytes = db->comp_bytes;
253 stats->comp_packets = db->comp_count;
254 stats->inc_bytes = db->incomp_bytes;
255 stats->inc_packets = db->incomp_count;
256 stats->in_count = db->in_count;
257 stats->bytes_out = db->bytes_out;
261 * Reset state, as on a CCP ResetReq.
263 static void bsd_reset (void *state,unsigned char code, unsigned char id,
264 unsigned char *data, unsigned len,
265 struct isdn_ppp_resetparams *rsparm)
267 struct bsd_db *db = (struct bsd_db *) state;
275 * Release the compression structure
277 static void bsd_free (void *state)
279 struct bsd_db *db = (struct bsd_db *) state;
283 * Release the dictionary
289 * Release the string buffer
295 * Finally release the structure itself.
303 * Allocate space for a (de) compressor.
305 static void *bsd_alloc (struct isdn_ppp_comp_data *data)
308 unsigned int hsize, hshift, maxmaxcode;
312 static unsigned int htab[][2] = {
313 { 5003 , 4 } , { 5003 , 4 } , { 5003 , 4 } , { 5003 , 4 } ,
314 { 9001 , 5 } , { 18013 , 6 } , { 35023 , 7 } , { 69001 , 8 }
317 if (data->optlen != 1 || data->num != CI_BSD_COMPRESS
318 || BSD_VERSION(data->options[0]) != BSD_CURRENT_VERSION)
321 bits = BSD_NBITS(data->options[0]);
323 if(bits < 9 || bits > 15)
326 hsize = htab[bits-9][0];
327 hshift = htab[bits-9][1];
330 * Allocate the main control structure for this instance.
332 maxmaxcode = MAXCODE(bits);
333 db = kzalloc (sizeof (struct bsd_db),GFP_KERNEL);
337 db->xmit = data->flags & IPPP_COMP_FLAG_XMIT;
338 decomp = db->xmit ? 0 : 1;
341 * Allocate space for the dictionary. This may be more than one page in
344 db->dict = vmalloc(hsize * sizeof(struct bsd_dict));
351 * If this is the compression buffer then there is no length data.
352 * For decompression, the length information is needed as well.
357 db->lens = vmalloc((maxmaxcode + 1) * sizeof(db->lens[0]));
365 * Initialize the data information for the compression code
367 db->totlen = sizeof (struct bsd_db) + (sizeof (struct bsd_dict) * hsize);
370 db->maxmaxcode = maxmaxcode;
377 * Initialize the database.
379 static int bsd_init (void *state, struct isdn_ppp_comp_data *data, int unit, int debug)
381 struct bsd_db *db = state;
385 if(!state || !data) {
386 printk(KERN_ERR "isdn_bsd_init: [%d] ERR, state %lx data %lx\n",unit,(long)state,(long)data);
390 decomp = db->xmit ? 0 : 1;
392 if (data->optlen != 1 || data->num != CI_BSD_COMPRESS
393 || (BSD_VERSION(data->options[0]) != BSD_CURRENT_VERSION)
394 || (BSD_NBITS(data->options[0]) != db->maxbits)
395 || (decomp && db->lens == NULL)) {
396 printk(KERN_ERR "isdn_bsd: %d %d %d %d %lx\n",data->optlen,data->num,data->options[0],decomp,(unsigned long)db->lens);
401 for(indx=LAST;indx>=0;indx--)
405 while (indx-- != 0) {
406 db->dict[indx].codem1 = BADCODEM1;
407 db->dict[indx].cptr = 0;
415 bsd_reset(db,0,0,NULL,0,NULL);
421 * Obtain pointers to the various structures in the compression tables
424 #define dict_ptrx(p,idx) &(p->dict[idx])
425 #define lens_ptrx(p,idx) &(p->lens[idx])
428 static unsigned short *lens_ptr(struct bsd_db *db, int idx)
430 if ((unsigned int) idx > (unsigned int) db->maxmaxcode) {
431 printk (KERN_DEBUG "<9>ppp: lens_ptr(%d) > max\n", idx);
434 return lens_ptrx (db, idx);
437 static struct bsd_dict *dict_ptr(struct bsd_db *db, int idx)
439 if ((unsigned int) idx >= (unsigned int) db->hsize) {
440 printk (KERN_DEBUG "<9>ppp: dict_ptr(%d) > max\n", idx);
443 return dict_ptrx (db, idx);
447 #define lens_ptr(db,idx) lens_ptrx(db,idx)
448 #define dict_ptr(db,idx) dict_ptrx(db,idx)
454 static int bsd_compress (void *state, struct sk_buff *skb_in, struct sk_buff *skb_out,int proto)
458 unsigned int max_ent;
464 struct bsd_dict *dictp;
466 int hval,disp,ilen,mxcode;
467 unsigned char *rptr = skb_in->data;
468 int isize = skb_in->len;
470 #define OUTPUT(ent) \
473 accm |= ((ent) << bitno); \
475 if(skb_out && skb_tailroom(skb_out) > 0) \
476 *(skb_put(skb_out,1)) = (unsigned char) (accm>>24); \
479 } while (bitno <= 24); \
483 * If the protocol is not in the range we're interested in,
484 * just return without compressing the packet. If it is,
485 * the protocol becomes the first byte to compress.
487 printk(KERN_DEBUG "bsd_compress called with %x\n",proto);
490 if (proto < 0x21 || proto > 0xf9 || !(proto & 0x1) )
493 db = (struct bsd_db *) state;
495 max_ent = db->max_ent;
499 mxcode = MAXCODE (n_bits);
501 /* This is the PPP header information */
502 if(skb_out && skb_tailroom(skb_out) >= 2) {
503 char *v = skb_put(skb_out,2);
504 /* we only push our own data on the header,
505 AC,PC and protos is pushed by caller */
506 v[0] = db->seqno >> 8;
510 ilen = ++isize; /* This is off by one, but that is what is in draft! */
514 fcode = BSD_KEY (ent, c);
515 hval = BSD_HASH (ent, c, hshift);
516 dictp = dict_ptr (db, hval);
518 /* Validate and then check the entry. */
519 if (dictp->codem1 >= max_ent)
522 if (dictp->fcode == fcode) {
523 ent = dictp->codem1 + 1;
524 continue; /* found (prefix,suffix) */
527 /* continue probing until a match or invalid entry */
528 disp = (hval == 0) ? 1 : hval;
532 if (hval >= db->hsize)
534 dictp = dict_ptr (db, hval);
535 if (dictp->codem1 >= max_ent)
537 } while (dictp->fcode != fcode);
539 ent = dictp->codem1 + 1; /* finally found (prefix,suffix) */
543 OUTPUT(ent); /* output the prefix */
545 /* code -> hashtable */
546 if (max_ent < db->maxmaxcode) {
547 struct bsd_dict *dictp2;
548 struct bsd_dict *dictp3;
551 /* expand code size if needed */
552 if (max_ent >= mxcode) {
553 db->n_bits = ++n_bits;
554 mxcode = MAXCODE (n_bits);
558 * Invalidate old hash table entry using
559 * this code, and then take it over.
561 dictp2 = dict_ptr (db, max_ent + 1);
563 dictp3 = dict_ptr (db, indx);
565 if (dictp3->codem1 == max_ent)
566 dictp3->codem1 = BADCODEM1;
569 dictp->codem1 = max_ent;
570 dictp->fcode = fcode;
571 db->max_ent = ++max_ent;
574 unsigned short *len1 = lens_ptr (db, max_ent);
575 unsigned short *len2 = lens_ptr (db, ent);
582 OUTPUT(ent); /* output the last code */
585 db->bytes_out += skb_out->len; /* Do not count bytes from here */
586 db->uncomp_bytes += isize;
587 db->in_count += isize;
592 ++db->bytes_out; /* must be set before calling bsd_check */
595 * Generate the clear command if needed
602 * Pad dribble bits of last code with ones.
603 * Do not emit a completely useless byte of ones.
605 if (bitno < 32 && skb_out && skb_tailroom(skb_out) > 0)
606 *(skb_put(skb_out,1)) = (unsigned char) ((accm | (0xff << (bitno-8))) >> 24);
609 * Increase code size if we would have without the packet
610 * boundary because the decompressor will do so.
612 if (max_ent >= mxcode && max_ent < db->maxmaxcode)
615 /* If output length is too large then this is an incompressible frame. */
616 if (!skb_out || (skb_out && skb_out->len >= skb_in->len) ) {
618 db->incomp_bytes += isize;
622 /* Count the number of compressed frames */
624 db->comp_bytes += skb_out->len;
631 * Update the "BSD Compress" dictionary on the receiver for
632 * incompressible data by pretending to compress the incoming data.
634 static void bsd_incomp (void *state, struct sk_buff *skb_in,int proto)
636 bsd_compress (state, skb_in, NULL, proto);
640 * Decompress "BSD Compress".
642 static int bsd_decompress (void *state, struct sk_buff *skb_in, struct sk_buff *skb_out,
643 struct isdn_ppp_resetparams *rsparm)
646 unsigned int max_ent;
648 unsigned int bitno; /* 1st valid bit in accm */
650 unsigned int tgtbitno; /* bitno when we have a code */
651 struct bsd_dict *dictp;
654 unsigned int oldcode;
655 unsigned int finchar;
656 unsigned char *p,*ibuf;
661 db = (struct bsd_db *) state;
662 max_ent = db->max_ent;
664 bitno = 32; /* 1st valid bit in accm */
666 tgtbitno = 32 - n_bits; /* bitno when we have a code */
668 printk(KERN_DEBUG "bsd_decompress called\n");
670 if(!skb_in || !skb_out) {
671 printk(KERN_ERR "bsd_decompress called with NULL parameter\n");
676 * Get the sequence number.
678 if( (p = skb_pull(skb_in,2)) == NULL) {
682 seq = (p[0] << 8) + p[1];
687 * Check the sequence number and give up if it differs from
688 * the value we're expecting.
690 if (seq != db->seqno) {
692 printk(KERN_DEBUG "bsd_decomp%d: bad sequence # %d, expected %d\n",
693 db->unit, seq, db->seqno - 1);
699 db->bytes_out += ilen;
701 if(skb_tailroom(skb_out) > 0)
702 *(skb_put(skb_out,1)) = 0;
704 return DECOMP_ERR_NOMEM;
709 * Keep the checkpoint correctly so that incompressible packets
710 * clear the dictionary at the proper times.
715 db->in_count += (skb_out->len - 1); /* don't count the header */
720 * Accumulate bytes until we have a complete code.
721 * Then get the next code, relying on the 32-bit,
722 * unsigned accm to mask the result.
726 accm |= *ibuf++ << bitno;
727 if (tgtbitno < bitno)
730 incode = accm >> tgtbitno;
735 * The dictionary must only be cleared at the end of a packet.
738 if (incode == CLEAR) {
741 printk(KERN_DEBUG "bsd_decomp%d: bad CLEAR\n", db->unit);
742 return DECOMP_FATALERROR; /* probably a bug */
748 if ((incode > max_ent + 2) || (incode > db->maxmaxcode)
749 || (incode > max_ent && oldcode == CLEAR)) {
751 printk(KERN_DEBUG "bsd_decomp%d: bad code 0x%x oldcode=0x%x ",
752 db->unit, incode, oldcode);
753 printk(KERN_DEBUG "max_ent=0x%x skb->Len=%d seqno=%d\n",
754 max_ent, skb_out->len, db->seqno);
756 return DECOMP_FATALERROR; /* probably a bug */
759 /* Special case for KwKwK string. */
760 if (incode > max_ent) {
768 codelen = *(lens_ptr (db, finchar));
769 if( skb_tailroom(skb_out) < codelen + extra) {
771 printk(KERN_DEBUG "bsd_decomp%d: ran out of mru\n", db->unit);
773 printk(KERN_DEBUG " len=%d, finchar=0x%x, codelen=%d,skblen=%d\n",
774 ilen, finchar, codelen, skb_out->len);
777 return DECOMP_FATALERROR;
781 * Decode this code and install it in the decompressed buffer.
784 p = skb_put(skb_out,codelen);
786 while (finchar > LAST) {
787 struct bsd_dict *dictp2 = dict_ptr (db, finchar);
789 dictp = dict_ptr (db, dictp2->cptr);
792 if (--codelen <= 0 || dictp->codem1 != finchar-1) {
794 printk(KERN_ERR "bsd_decomp%d: fell off end of chain ", db->unit);
795 printk(KERN_ERR "0x%x at 0x%x by 0x%x, max_ent=0x%x\n", incode, finchar, dictp2->cptr, max_ent);
797 if (dictp->codem1 != finchar-1) {
798 printk(KERN_ERR "bsd_decomp%d: bad code chain 0x%x finchar=0x%x ",db->unit, incode, finchar);
799 printk(KERN_ERR "oldcode=0x%x cptr=0x%x codem1=0x%x\n", oldcode, dictp2->cptr, dictp->codem1);
802 return DECOMP_FATALERROR;
807 u32 fcode = dictp->fcode;
808 *--p = (fcode >> 16) & 0xff;
809 finchar = fcode & 0xffff;
816 printk(KERN_ERR "bsd_decomp%d: short by %d after code 0x%x, max_ent=0x%x\n", db->unit, codelen, incode, max_ent);
819 if (extra) /* the KwKwK case again */
820 *(skb_put(skb_out,1)) = finchar;
823 * If not first code in a packet, and
824 * if not out of code space, then allocate a new code.
826 * Keep the hash table correct so it can be used
827 * with uncompressed packets.
829 if (oldcode != CLEAR && max_ent < db->maxmaxcode) {
830 struct bsd_dict *dictp2, *dictp3;
833 int hval, disp, indx;
835 fcode = BSD_KEY(oldcode,finchar);
836 hval = BSD_HASH(oldcode,finchar,db->hshift);
837 dictp = dict_ptr (db, hval);
839 /* look for a free hash table entry */
840 if (dictp->codem1 < max_ent) {
841 disp = (hval == 0) ? 1 : hval;
844 if (hval >= db->hsize)
846 dictp = dict_ptr (db, hval);
847 } while (dictp->codem1 < max_ent);
851 * Invalidate previous hash table entry
852 * assigned this code, and then take it over
855 dictp2 = dict_ptr (db, max_ent + 1);
857 dictp3 = dict_ptr (db, indx);
859 if (dictp3->codem1 == max_ent)
860 dictp3->codem1 = BADCODEM1;
863 dictp->codem1 = max_ent;
864 dictp->fcode = fcode;
865 db->max_ent = ++max_ent;
867 /* Update the length of this string. */
868 lens1 = lens_ptr (db, max_ent);
869 lens2 = lens_ptr (db, oldcode);
872 /* Expand code size if needed. */
873 if (max_ent >= MAXCODE(n_bits) && max_ent < db->maxmaxcode) {
874 db->n_bits = ++n_bits;
875 tgtbitno = 32-n_bits;
883 db->comp_bytes += skb_in->len - BSD_OVHD;
884 db->uncomp_bytes += skb_out->len;
888 printk(KERN_DEBUG "bsd_decomp%d: peer should have cleared dictionary on %d\n",
889 db->unit, db->seqno - 1);
894 /*************************************************************
895 * Table of addresses for the BSD compression module
896 *************************************************************/
898 static struct isdn_ppp_compressor ippp_bsd_compress = {
899 .owner = THIS_MODULE,
900 .num = CI_BSD_COMPRESS,
905 .compress = bsd_compress,
906 .decompress = bsd_decompress,
907 .incomp = bsd_incomp,
911 /*************************************************************
912 * Module support routines
913 *************************************************************/
915 static int __init isdn_bsdcomp_init(void)
917 int answer = isdn_ppp_register_compressor (&ippp_bsd_compress);
919 printk (KERN_INFO "PPP BSD Compression module registered\n");
923 static void __exit isdn_bsdcomp_exit(void)
925 isdn_ppp_unregister_compressor (&ippp_bsd_compress);
928 module_init(isdn_bsdcomp_init);
929 module_exit(isdn_bsdcomp_exit);