ChengsongTanPhdThesis/Chapters/Introduction.tex
author Chengsong
Sun, 25 Sep 2022 01:40:12 +0100
changeset 604 16d67f9c07d4
parent 603 370fe1dde7c7
child 605 ed53ce26ecb6
permissions -rwxr-xr-x
more
Ignore whitespace changes - Everywhere: Within whitespace: At end of lines:
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     1
% Chapter 1
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     2
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     3
\chapter{Introduction} % Main chapter title
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     4
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     5
\label{Introduction} % For referencing the chapter elsewhere, use \ref{Chapter1} 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     6
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     7
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     8
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
     9
% Define some commands to keep the formatting separated from the content 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    10
\newcommand{\keyword}[1]{\textbf{#1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    11
\newcommand{\tabhead}[1]{\textbf{#1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    12
\newcommand{\code}[1]{\texttt{#1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    13
\newcommand{\file}[1]{\texttt{\bfseries#1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    14
\newcommand{\option}[1]{\texttt{\itshape#1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    15
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    16
%boxes
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    17
\newcommand*{\mybox}[1]{\framebox{\strut #1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    18
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    19
%\newcommand{\sflataux}[1]{\textit{sflat}\_\textit{aux} \, #1}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    20
\newcommand\sflat[1]{\llparenthesis #1 \rrparenthesis }
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    21
\newcommand{\ASEQ}[3]{\textit{ASEQ}_{#1} \, #2 \, #3}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
    22
\newcommand{\bderssimp}[2]{#1 \backslash_{bsimps} #2}
596
b306628a0eab more chap 56
Chengsong
parents: 594
diff changeset
    23
\newcommand{\rderssimp}[2]{#1 \backslash_{rsimps} #2}
564
Chengsong
parents: 558
diff changeset
    24
\def\derssimp{\textit{ders}\_\textit{simp}}
557
812e5d112f49 more changes
Chengsong
parents: 556
diff changeset
    25
\def\rders{\textit{rders}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    26
\newcommand{\bders}[2]{#1 \backslash #2}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    27
\newcommand{\bsimp}[1]{\textit{bsimp}(#1)}
591
b2d0de6aee18 more polishing integrated comments chap2
Chengsong
parents: 590
diff changeset
    28
\def\bsimps{\textit{bsimp}}
554
Chengsong
parents: 543
diff changeset
    29
\newcommand{\rsimp}[1]{\textit{rsimp}\; #1}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    30
\newcommand{\sflataux}[1]{\llparenthesis #1 \rrparenthesis'}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    31
\newcommand{\dn}{\stackrel{\mbox{\scriptsize def}}{=}}%
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    32
\newcommand{\denote}{\stackrel{\mbox{\scriptsize denote}}{=}}%
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    33
\newcommand{\ZERO}{\mbox{\bf 0}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    34
\newcommand{\ONE}{\mbox{\bf 1}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    35
\newcommand{\AALTS}[2]{\oplus {\scriptstyle #1}\, #2}
555
Chengsong
parents: 554
diff changeset
    36
\newcommand{\rdistinct}[2]{\textit{rdistinct} \;\; #1 \;\; #2}
594
Chengsong
parents: 591
diff changeset
    37
\def\rdistincts{\textit{rdistinct}}
556
Chengsong
parents: 555
diff changeset
    38
\def\rDistinct{\textit{rdistinct}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    39
\newcommand\hflat[1]{\llparenthesis  #1 \rrparenthesis_*}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    40
\newcommand\hflataux[1]{\llparenthesis #1 \rrparenthesis_*'}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    41
\newcommand\createdByStar[1]{\textit{createdByStar}(#1)}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    42
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    43
\newcommand\myequiv{\mathrel{\stackrel{\makebox[0pt]{\mbox{\normalfont\tiny equiv}}}{=}}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    44
600
fd068f39ac23 chap4 comments done
Chengsong
parents: 596
diff changeset
    45
\def\SEQ{\textit{SEQ}}
fd068f39ac23 chap4 comments done
Chengsong
parents: 596
diff changeset
    46
\def\SEQs{\textit{SEQs}}
564
Chengsong
parents: 558
diff changeset
    47
\def\case{\textit{case}}
554
Chengsong
parents: 543
diff changeset
    48
\def\sequal{\stackrel{\mbox{\scriptsize rsimp}}{=}}
Chengsong
parents: 543
diff changeset
    49
\def\rsimpalts{\textit{rsimp}_{ALTS}}
Chengsong
parents: 543
diff changeset
    50
\def\good{\textit{good}}
Chengsong
parents: 543
diff changeset
    51
\def\btrue{\textit{true}}
Chengsong
parents: 543
diff changeset
    52
\def\bfalse{\textit{false}}
542
a7344c9afbaf chapter3 finished
Chengsong
parents: 538
diff changeset
    53
\def\bnullable{\textit{bnullable}}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
    54
\def\bnullables{\textit{bnullables}}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
    55
\def\Some{\textit{Some}}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
    56
\def\None{\textit{None}}
537
Chengsong
parents: 532
diff changeset
    57
\def\code{\textit{code}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    58
\def\decode{\textit{decode}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    59
\def\internalise{\textit{internalise}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    60
\def\lexer{\mathit{lexer}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    61
\def\mkeps{\textit{mkeps}}
557
812e5d112f49 more changes
Chengsong
parents: 556
diff changeset
    62
\newcommand{\rder}[2]{#2 \backslash_r #1}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    63
585
4969ef817d92 chap4 more
Chengsong
parents: 579
diff changeset
    64
\def\rerases{\textit{rerase}}
4969ef817d92 chap4 more
Chengsong
parents: 579
diff changeset
    65
554
Chengsong
parents: 543
diff changeset
    66
\def\nonnested{\textit{nonnested}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    67
\def\AZERO{\textit{AZERO}}
558
Chengsong
parents: 557
diff changeset
    68
\def\sizeNregex{\textit{sizeNregex}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    69
\def\AONE{\textit{AONE}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    70
\def\ACHAR{\textit{ACHAR}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    71
585
4969ef817d92 chap4 more
Chengsong
parents: 579
diff changeset
    72
\def\simpsulz{\textit{simp}_{Sulz}}
4969ef817d92 chap4 more
Chengsong
parents: 579
diff changeset
    73
557
812e5d112f49 more changes
Chengsong
parents: 556
diff changeset
    74
\def\scfrewrites{\stackrel{*}{\rightsquigarrow_{scf}}}
555
Chengsong
parents: 554
diff changeset
    75
\def\frewrite{\rightsquigarrow_f}
Chengsong
parents: 554
diff changeset
    76
\def\hrewrite{\rightsquigarrow_h}
Chengsong
parents: 554
diff changeset
    77
\def\grewrite{\rightsquigarrow_g}
Chengsong
parents: 554
diff changeset
    78
\def\frewrites{\stackrel{*}{\rightsquigarrow_f}}
Chengsong
parents: 554
diff changeset
    79
\def\hrewrites{\stackrel{*}{\rightsquigarrow_h}}
Chengsong
parents: 554
diff changeset
    80
\def\grewrites{\stackrel{*}{\rightsquigarrow_g}}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
    81
\def\fuse{\textit{fuse}}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
    82
\def\bder{\textit{bder}}
542
a7344c9afbaf chapter3 finished
Chengsong
parents: 538
diff changeset
    83
\def\der{\textit{der}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    84
\def\POSIX{\textit{POSIX}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    85
\def\ALTS{\textit{ALTS}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    86
\def\ASTAR{\textit{ASTAR}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    87
\def\DFA{\textit{DFA}}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
    88
\def\NFA{\textit{NFA}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    89
\def\bmkeps{\textit{bmkeps}}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
    90
\def\bmkepss{\textit{bmkepss}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    91
\def\retrieve{\textit{retrieve}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    92
\def\blexer{\textit{blexer}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
    93
\def\flex{\textit{flex}}
573
454ced557605 chapter2 finished polishing
Chengsong
parents: 567
diff changeset
    94
\def\inj{\textit{inj}}
564
Chengsong
parents: 558
diff changeset
    95
\def\Empty{\textit{Empty}}
567
28cb8089ec36 more updaates
Chengsong
parents: 564
diff changeset
    96
\def\Left{\textit{Left}}
28cb8089ec36 more updaates
Chengsong
parents: 564
diff changeset
    97
\def\Right{\textit{Right}}
573
454ced557605 chapter2 finished polishing
Chengsong
parents: 567
diff changeset
    98
\def\Stars{\textit{Stars}}
454ced557605 chapter2 finished polishing
Chengsong
parents: 567
diff changeset
    99
\def\Char{\textit{Char}}
454ced557605 chapter2 finished polishing
Chengsong
parents: 567
diff changeset
   100
\def\Seq{\textit{Seq}}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   101
\def\Der{\textit{Der}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   102
\def\Ders{\textit{Ders}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   103
\def\nullable{\mathit{nullable}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   104
\def\Z{\mathit{Z}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   105
\def\S{\mathit{S}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   106
\def\rup{r^\uparrow}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   107
%\def\bderssimp{\mathit{bders}\_\mathit{simp}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   108
\def\distinctWith{\textit{distinctWith}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   109
\def\lf{\textit{lf}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   110
\def\PD{\textit{PD}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   111
\def\suffix{\textit{Suffix}}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   112
\def\distinctBy{\textit{distinctBy}}
558
Chengsong
parents: 557
diff changeset
   113
\def\starupdate{\textit{starUpdate}}
Chengsong
parents: 557
diff changeset
   114
\def\starupdates{\textit{starUpdates}}
Chengsong
parents: 557
diff changeset
   115
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   116
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   117
\def\size{\mathit{size}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   118
\def\rexp{\mathbf{rexp}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   119
\def\simp{\mathit{simp}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   120
\def\simpALTs{\mathit{simp}\_\mathit{ALTs}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   121
\def\map{\mathit{map}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   122
\def\distinct{\mathit{distinct}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   123
\def\blexersimp{\mathit{blexer}\_\mathit{simp}}
590
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   124
\def\blexerStrong{\textit{blexerStrong}}
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   125
\def\bsimpStrong{\textit{bsimpStrong}}
591
b2d0de6aee18 more polishing integrated comments chap2
Chengsong
parents: 590
diff changeset
   126
\def\bdersStrongs{\textit{bdersStrong}}
590
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   127
\newcommand{\bdersStrong}[2]{#1 \backslash_{bsimpStrongs} #2}
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   128
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   129
\def\map{\textit{map}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   130
\def\rrexp{\textit{rrexp}}
554
Chengsong
parents: 543
diff changeset
   131
\newcommand\rnullable[1]{\textit{rnullable} \; #1 }
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   132
\newcommand\rsize[1]{\llbracket #1 \rrbracket_r}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   133
\newcommand\asize[1]{\llbracket #1 \rrbracket}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   134
\newcommand\rerase[1]{ (#1)_{\downarrow_r}}
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   135
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   136
\newcommand\ChristianComment[1]{\textcolor{blue}{#1}\\}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   137
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   138
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   139
\def\rflts{\textit{rflts}}
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   140
\def\rrewrite{\textit{rrewrite}}
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   141
\def\bsimpalts{\textit{bsimp}_{ALTS}}
596
b306628a0eab more chap 56
Chengsong
parents: 594
diff changeset
   142
\def\bsimpaseq{\textit{bsimp}_{ASEQ}}
b306628a0eab more chap 56
Chengsong
parents: 594
diff changeset
   143
\def\rsimlalts{\textit{rsimp}_{ALTs}}
b306628a0eab more chap 56
Chengsong
parents: 594
diff changeset
   144
\def\rsimpseq{\textit{rsimp}_{SEQ}}
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   145
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   146
\def\erase{\textit{erase}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   147
\def\STAR{\textit{STAR}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   148
\def\flts{\textit{flts}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   149
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   150
579
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   151
\def\zeroable{\textit{zeroable}}
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   152
\def\nub{\textit{nub}}
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   153
\def\filter{\textit{filter}}
601
Chengsong
parents: 600
diff changeset
   154
%\def\not{\textit{not}}
579
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   155
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   156
35df9cdd36ca more chap3
Chengsong
parents: 573
diff changeset
   157
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   158
\def\RZERO{\mathbf{0}_r }
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   159
\def\RONE{\mathbf{1}_r}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   160
\newcommand\RCHAR[1]{\mathbf{#1}_r}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   161
\newcommand\RSEQ[2]{#1 \cdot #2}
558
Chengsong
parents: 557
diff changeset
   162
\newcommand\RALTS[1]{\sum #1}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   163
\newcommand\RSTAR[1]{#1^*}
558
Chengsong
parents: 557
diff changeset
   164
\newcommand\vsuf[2]{\textit{Suffix} \;#1\;#2}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   165
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   166
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   167
590
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   168
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   169
\lstdefinestyle{myScalastyle}{
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   170
  frame=tb,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   171
  language=scala,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   172
  aboveskip=3mm,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   173
  belowskip=3mm,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   174
  showstringspaces=false,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   175
  columns=flexible,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   176
  basicstyle={\small\ttfamily},
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   177
  numbers=none,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   178
  numberstyle=\tiny\color{gray},
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   179
  keywordstyle=\color{blue},
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   180
  commentstyle=\color{dkgreen},
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   181
  stringstyle=\color{mauve},
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   182
  frame=single,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   183
  breaklines=true,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   184
  breakatwhitespace=true,
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   185
  tabsize=3,
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   186
}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   187
590
988e92a70704 more chap5 and chap6 bsimp_idem
Chengsong
parents: 585
diff changeset
   188
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   189
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   190
%This part is about regular expressions, Brzozowski derivatives,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   191
%and a bit-coded lexing algorithm with proven correctness and time bounds.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   192
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   193
%TODO: look up snort rules to use here--give readers idea of what regexes look like
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   194
601
Chengsong
parents: 600
diff changeset
   195
Chengsong
parents: 600
diff changeset
   196
Chengsong
parents: 600
diff changeset
   197
Chengsong
parents: 600
diff changeset
   198
Chengsong
parents: 600
diff changeset
   199
Chengsong
parents: 600
diff changeset
   200
Regular expressions are widely used in computer science: 
Chengsong
parents: 600
diff changeset
   201
be it in text-editors \parencite{atomEditor} with syntax highlighting and auto-completion;
Chengsong
parents: 600
diff changeset
   202
command-line tools like $\mathit{grep}$ that facilitate easy 
Chengsong
parents: 600
diff changeset
   203
text-processing; network intrusion
Chengsong
parents: 600
diff changeset
   204
detection systems that reject suspicious traffic; or compiler
Chengsong
parents: 600
diff changeset
   205
front ends--the majority of the solutions to these tasks 
Chengsong
parents: 600
diff changeset
   206
involve lexing with regular 
Chengsong
parents: 600
diff changeset
   207
expressions.
Chengsong
parents: 600
diff changeset
   208
Given its usefulness and ubiquity, one would imagine that
Chengsong
parents: 600
diff changeset
   209
modern regular expression matching implementations
Chengsong
parents: 600
diff changeset
   210
are mature and fully studied.
602
Chengsong
parents: 601
diff changeset
   211
Indeed, in a popular programming language's regex engine, 
Chengsong
parents: 601
diff changeset
   212
supplying it with regular expressions and strings,
Chengsong
parents: 601
diff changeset
   213
in most cases one can
Chengsong
parents: 601
diff changeset
   214
get the matching information in a very short time.
Chengsong
parents: 601
diff changeset
   215
Those matchers can be blindingly fast--some 
Chengsong
parents: 601
diff changeset
   216
network intrusion detection systems
601
Chengsong
parents: 600
diff changeset
   217
use regex engines that are able to process 
Chengsong
parents: 600
diff changeset
   218
megabytes or even gigabytes of data per second \parencite{Turo_ov__2020}.
602
Chengsong
parents: 601
diff changeset
   219
However, those matchers can exhibit a surprising security vulnerability
Chengsong
parents: 601
diff changeset
   220
under a certain class of inputs.
Chengsong
parents: 601
diff changeset
   221
%However, , this is not the case for $\mathbf{all}$ inputs.
601
Chengsong
parents: 600
diff changeset
   222
%TODO: get source for SNORT/BRO's regex matching engine/speed
Chengsong
parents: 600
diff changeset
   223
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   224
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   225
Take $(a^*)^*\,b$ and ask whether
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   226
strings of the form $aa..a$ match this regular
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   227
expression. Obviously this is not the case---the expected $b$ in the last
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   228
position is missing. One would expect that modern regular expression
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   229
matching engines can find this out very quickly. Alas, if one tries
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   230
this example in JavaScript, Python or Java 8, even with strings of a small
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   231
length, say around 30 $a$'s,
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   232
the decision takes crazy time to finish (graph \ref{fig:aStarStarb}).
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   233
This is clearly exponential behaviour, and 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   234
is triggered by some relatively simple regex patterns.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   235
Java 9 and newer
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   236
versions improves this behaviour, but is still slow compared 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   237
with the approach we are going to use.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   238
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   239
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   240
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   241
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   242
This superlinear blowup in regular expression engines
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   243
had repeatedly caused grief in real life that they
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   244
get a name for them--``catastrophic backtracking''.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   245
For example, on 20 July 2016 one evil
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   246
regular expression brought the webpage
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   247
\href{http://stackexchange.com}{Stack Exchange} to its
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   248
knees.\footnote{\url{https://stackstatus.net/post/147710624694/outage-postmortem-july-20-2016}(Last accessed in 2019)}
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   249
In this instance, a regular expression intended to just trim white
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   250
spaces from the beginning and the end of a line actually consumed
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   251
massive amounts of CPU resources---causing web servers to grind to a
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   252
halt. In this example, the time needed to process
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   253
the string was $O(n^2)$ with respect to the string length. This
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   254
quadratic overhead was enough for the homepage of Stack Exchange to
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   255
respond so slowly that the load balancer assumed a $\mathit{DoS}$ 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   256
attack and therefore stopped the servers from responding to any
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   257
requests. This made the whole site become unavailable. 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   258
601
Chengsong
parents: 600
diff changeset
   259
\begin{figure}[p]
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   260
\begin{tabular}{@{}c@{\hspace{0mm}}c@{\hspace{0mm}}c@{}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   261
\begin{tikzpicture}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   262
\begin{axis}[
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   263
    xlabel={$n$},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   264
    x label style={at={(1.05,-0.05)}},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   265
    ylabel={time in secs},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   266
    enlargelimits=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   267
    xtick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   268
    xmax=33,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   269
    ymax=35,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   270
    ytick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   271
    scaled ticks=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   272
    axis lines=left,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   273
    width=5cm,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   274
    height=4cm, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   275
    legend entries={JavaScript},  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   276
    legend pos=north west,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   277
    legend cell align=left]
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   278
\addplot[red,mark=*, mark options={fill=white}] table {re-js.data};
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   279
\end{axis}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   280
\end{tikzpicture}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   281
  &
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   282
\begin{tikzpicture}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   283
\begin{axis}[
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   284
    xlabel={$n$},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   285
    x label style={at={(1.05,-0.05)}},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   286
    %ylabel={time in secs},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   287
    enlargelimits=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   288
    xtick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   289
    xmax=33,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   290
    ymax=35,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   291
    ytick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   292
    scaled ticks=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   293
    axis lines=left,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   294
    width=5cm,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   295
    height=4cm, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   296
    legend entries={Python},  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   297
    legend pos=north west,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   298
    legend cell align=left]
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   299
\addplot[blue,mark=*, mark options={fill=white}] table {re-python2.data};
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   300
\end{axis}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   301
\end{tikzpicture}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   302
  &
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   303
\begin{tikzpicture}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   304
\begin{axis}[
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   305
    xlabel={$n$},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   306
    x label style={at={(1.05,-0.05)}},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   307
    %ylabel={time in secs},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   308
    enlargelimits=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   309
    xtick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   310
    xmax=33,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   311
    ymax=35,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   312
    ytick={0,5,...,30},
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   313
    scaled ticks=false,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   314
    axis lines=left,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   315
    width=5cm,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   316
    height=4cm, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   317
    legend entries={Java 8},  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   318
    legend pos=north west,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   319
    legend cell align=left]
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   320
\addplot[cyan,mark=*, mark options={fill=white}] table {re-java.data};
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   321
\end{axis}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   322
\end{tikzpicture}\\
601
Chengsong
parents: 600
diff changeset
   323
\begin{tikzpicture}
Chengsong
parents: 600
diff changeset
   324
\begin{axis}[
Chengsong
parents: 600
diff changeset
   325
    xlabel={$n$},
Chengsong
parents: 600
diff changeset
   326
    x label style={at={(1.05,-0.05)}},
Chengsong
parents: 600
diff changeset
   327
    ylabel={time in secs},
Chengsong
parents: 600
diff changeset
   328
    enlargelimits=false,
Chengsong
parents: 600
diff changeset
   329
    xtick={0,5,...,30},
Chengsong
parents: 600
diff changeset
   330
    xmax=33,
Chengsong
parents: 600
diff changeset
   331
    ymax=35,
Chengsong
parents: 600
diff changeset
   332
    ytick={0,5,...,30},
Chengsong
parents: 600
diff changeset
   333
    scaled ticks=false,
Chengsong
parents: 600
diff changeset
   334
    axis lines=left,
Chengsong
parents: 600
diff changeset
   335
    width=5cm,
Chengsong
parents: 600
diff changeset
   336
    height=4cm, 
Chengsong
parents: 600
diff changeset
   337
    legend entries={Dart},  
Chengsong
parents: 600
diff changeset
   338
    legend pos=north west,
Chengsong
parents: 600
diff changeset
   339
    legend cell align=left]
Chengsong
parents: 600
diff changeset
   340
\addplot[green,mark=*, mark options={fill=white}] table {re-dart.data};
Chengsong
parents: 600
diff changeset
   341
\end{axis}
Chengsong
parents: 600
diff changeset
   342
\end{tikzpicture}
Chengsong
parents: 600
diff changeset
   343
  &
Chengsong
parents: 600
diff changeset
   344
\begin{tikzpicture}
Chengsong
parents: 600
diff changeset
   345
\begin{axis}[
Chengsong
parents: 600
diff changeset
   346
    xlabel={$n$},
Chengsong
parents: 600
diff changeset
   347
    x label style={at={(1.05,-0.05)}},
Chengsong
parents: 600
diff changeset
   348
    %ylabel={time in secs},
Chengsong
parents: 600
diff changeset
   349
    enlargelimits=false,
Chengsong
parents: 600
diff changeset
   350
    xtick={0,5,...,30},
Chengsong
parents: 600
diff changeset
   351
    xmax=33,
Chengsong
parents: 600
diff changeset
   352
    ymax=35,
Chengsong
parents: 600
diff changeset
   353
    ytick={0,5,...,30},
Chengsong
parents: 600
diff changeset
   354
    scaled ticks=false,
Chengsong
parents: 600
diff changeset
   355
    axis lines=left,
Chengsong
parents: 600
diff changeset
   356
    width=5cm,
Chengsong
parents: 600
diff changeset
   357
    height=4cm, 
Chengsong
parents: 600
diff changeset
   358
    legend entries={Swift},  
Chengsong
parents: 600
diff changeset
   359
    legend pos=north west,
Chengsong
parents: 600
diff changeset
   360
    legend cell align=left]
Chengsong
parents: 600
diff changeset
   361
\addplot[purple,mark=*, mark options={fill=white}] table {re-swift.data};
Chengsong
parents: 600
diff changeset
   362
\end{axis}
Chengsong
parents: 600
diff changeset
   363
\end{tikzpicture}
Chengsong
parents: 600
diff changeset
   364
  & \\
Chengsong
parents: 600
diff changeset
   365
\multicolumn{3}{c}{Graphs}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   366
\end{tabular}    
601
Chengsong
parents: 600
diff changeset
   367
\caption{Graphs showing runtime for matching $(a^*)^*\,b$ with strings 
Chengsong
parents: 600
diff changeset
   368
           of the form $\protect\underbrace{aa..a}_{n}$ in various existing regular expression libraries.
Chengsong
parents: 600
diff changeset
   369
   The reason for their superlinear behaviour is that they do a depth-first-search.
Chengsong
parents: 600
diff changeset
   370
   If the string does not match, the engine starts to explore all possibilities. 
Chengsong
parents: 600
diff changeset
   371
}\label{fig:aStarStarb}
Chengsong
parents: 600
diff changeset
   372
\end{figure}\afterpage{\clearpage}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   373
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   374
A more recent example is a global outage of all Cloudflare servers on 2 July
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   375
2019. A poorly written regular expression exhibited exponential
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   376
behaviour and exhausted CPUs that serve HTTP traffic. Although the outage
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   377
had several causes, at the heart was a regular expression that
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   378
was used to monitor network
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   379
traffic.\footnote{\url{https://blog.cloudflare.com/details-of-the-cloudflare-outage-on-july-2-2019/}(Last accessed in 2022)}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   380
These problems with regular expressions 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   381
are not isolated events that happen
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   382
very occasionally, but actually widespread.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   383
They occur so often that they get a 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   384
name--Regular-Expression-Denial-Of-Service (ReDoS)
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   385
attack.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   386
\citeauthor{Davis18} detected more
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   387
than 1000 super-linear (SL) regular expressions
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   388
in Node.js, Python core libraries, and npm and pypi. 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   389
They therefore concluded that evil regular expressions
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   390
are problems "more than a parlour trick", but one that
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   391
requires
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   392
more research attention.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   393
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   394
This work aims to address this issue
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   395
with the help of formal proofs.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   396
We offer a lexing algorithm based
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   397
on Brzozowski derivatives with certified correctness (in 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   398
Isabelle/HOL)
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   399
and finiteness property.
604
Chengsong
parents: 603
diff changeset
   400
Such properties guarantee the absence of 
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   401
catastrophic backtracking in most cases.
604
Chengsong
parents: 603
diff changeset
   402
We will give more details in the next sections
Chengsong
parents: 603
diff changeset
   403
on (i) why the slow cases in graph \ref{fig:aStarStarb}
Chengsong
parents: 603
diff changeset
   404
can occur
Chengsong
parents: 603
diff changeset
   405
and (ii) why we choose our 
Chengsong
parents: 603
diff changeset
   406
approach (Brzozowski derivatives and formal proofs).
602
Chengsong
parents: 601
diff changeset
   407
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   408
604
Chengsong
parents: 603
diff changeset
   409
\section{Terminology, and the Problem with Bounded Repetitions}
601
Chengsong
parents: 600
diff changeset
   410
Regular expressions and regular expression matchers 
Chengsong
parents: 600
diff changeset
   411
have of course been studied for many, many years.
604
Chengsong
parents: 603
diff changeset
   412
Theoretical results in automata theory says
Chengsong
parents: 603
diff changeset
   413
that basic regular expression matching should be linear
Chengsong
parents: 603
diff changeset
   414
w.r.t the input, provided that the regular expression
Chengsong
parents: 603
diff changeset
   415
$r$ had been pre-processed and turned into a
Chengsong
parents: 603
diff changeset
   416
deterministic finite automata (DFA).
Chengsong
parents: 603
diff changeset
   417
By basic we mean textbook definitions such as the one
Chengsong
parents: 603
diff changeset
   418
below, involving only characters, alternatives,
Chengsong
parents: 603
diff changeset
   419
sequences, and Kleene stars:
Chengsong
parents: 603
diff changeset
   420
\[
Chengsong
parents: 603
diff changeset
   421
	r ::= \ZERO | \ONE | c | r_1 + r_2 | r_1 \cdot r_2 | r^*
Chengsong
parents: 603
diff changeset
   422
\]
Chengsong
parents: 603
diff changeset
   423
Modern regular expression matchers used by programmers,
Chengsong
parents: 603
diff changeset
   424
however,
Chengsong
parents: 603
diff changeset
   425
support richer constructs such as bounded repetitions
Chengsong
parents: 603
diff changeset
   426
and back-references.
Chengsong
parents: 603
diff changeset
   427
The syntax and expressive power of those 
Chengsong
parents: 603
diff changeset
   428
matching engines
Chengsong
parents: 603
diff changeset
   429
make ``regular expressions'' quite different from 
Chengsong
parents: 603
diff changeset
   430
their original meaning in the formal languages
Chengsong
parents: 603
diff changeset
   431
theory.
Chengsong
parents: 603
diff changeset
   432
To differentiate, people tend to use the word \emph{regex} to refer
Chengsong
parents: 603
diff changeset
   433
those expressions with richer constructs, and regular expressions
Chengsong
parents: 603
diff changeset
   434
for the more traditional meaning.
Chengsong
parents: 603
diff changeset
   435
For example, the PCRE standard (Peral Compatible Regular Expressions)
Chengsong
parents: 603
diff changeset
   436
is such a regex syntax standard.
Chengsong
parents: 603
diff changeset
   437
We follow this convention in this thesis.
Chengsong
parents: 603
diff changeset
   438
We aim to support all the popular features of regexes in the future,
Chengsong
parents: 603
diff changeset
   439
but for this work we mainly look at regular expressions.
Chengsong
parents: 603
diff changeset
   440
Chengsong
parents: 603
diff changeset
   441
\subsection{A Little Introduction to Regexes: Bounded Repetitions
Chengsong
parents: 603
diff changeset
   442
and Back-references}
Chengsong
parents: 603
diff changeset
   443
Regexes come with a lot of constructs
Chengsong
parents: 603
diff changeset
   444
that makes it more convenient for 
Chengsong
parents: 603
diff changeset
   445
programmers to write regular expressions.
Chengsong
parents: 603
diff changeset
   446
Some of those constructs are syntactic sugars that are
Chengsong
parents: 603
diff changeset
   447
simply short hand notations
Chengsong
parents: 603
diff changeset
   448
that save the programmers a few keystrokes,
Chengsong
parents: 603
diff changeset
   449
for example the
Chengsong
parents: 603
diff changeset
   450
non-binary alternative involving three or more choices:
Chengsong
parents: 603
diff changeset
   451
\[
Chengsong
parents: 603
diff changeset
   452
	r = (a | b | c | \ldots | z)^*
Chengsong
parents: 603
diff changeset
   453
\]
Chengsong
parents: 603
diff changeset
   454
, the range operator $-$ which means the alternative
Chengsong
parents: 603
diff changeset
   455
of all characters between its operands:
Chengsong
parents: 603
diff changeset
   456
\[
Chengsong
parents: 603
diff changeset
   457
	r = [0-9a-zA-Z] \; \text{(all alpha-numeric characters)}
Chengsong
parents: 603
diff changeset
   458
\]
Chengsong
parents: 603
diff changeset
   459
and the 
Chengsong
parents: 603
diff changeset
   460
wildcard character $.$ meaning any character
Chengsong
parents: 603
diff changeset
   461
\[
Chengsong
parents: 603
diff changeset
   462
	. = [0-9a-zA-Z+-()*&\ldots]
Chengsong
parents: 603
diff changeset
   463
Chengsong
parents: 603
diff changeset
   464
\]
Chengsong
parents: 603
diff changeset
   465
Some of those constructs do make the expressions much
Chengsong
parents: 603
diff changeset
   466
more compact, and matching time could be greatly increase.
Chengsong
parents: 603
diff changeset
   467
For example, $r^{n}$ is exponentially more concise compared with
Chengsong
parents: 603
diff changeset
   468
the expression $\underbrace{r}_\text{n copies of r}$,
Chengsong
parents: 603
diff changeset
   469
and therefore a naive algorithm that simply unfolds
Chengsong
parents: 603
diff changeset
   470
$r^{n}$ into $\underbrace{r}_\text{n copies of r}$
Chengsong
parents: 603
diff changeset
   471
will suffer exponential runtime increase.
Chengsong
parents: 603
diff changeset
   472
Some constructs can even raise the expressive
Chengsong
parents: 603
diff changeset
   473
power to the non-regular realm, for example
Chengsong
parents: 603
diff changeset
   474
the back-references.
Chengsong
parents: 603
diff changeset
   475
Chengsong
parents: 603
diff changeset
   476
bounded repetitions, as we have discussed in the 
Chengsong
parents: 603
diff changeset
   477
previous section.
Chengsong
parents: 603
diff changeset
   478
This super-linear behaviour of the 
Chengsong
parents: 603
diff changeset
   479
regex matching engines we have?
601
Chengsong
parents: 600
diff changeset
   480
One of the most recent work in the context of lexing
Chengsong
parents: 600
diff changeset
   481
is the Verbatim lexer by Egolf, Lasser and Fisher\cite{Verbatim}.
Chengsong
parents: 600
diff changeset
   482
This is relevant work and we will compare later on
Chengsong
parents: 600
diff changeset
   483
our derivative-based matcher we are going to present.
Chengsong
parents: 600
diff changeset
   484
There is also some newer work called
Chengsong
parents: 600
diff changeset
   485
Verbatim++\cite{Verbatimpp}, this does not use derivatives, but automaton instead.
602
Chengsong
parents: 601
diff changeset
   486
For that the problem is dealing with the bounded regular expressions of the form
Chengsong
parents: 601
diff changeset
   487
$r^{n}$ where $n$ is a constant specifying that $r$ must repeat
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   488
exactly $n$ times. The Verbatim++ lexer becomes excruciatingly slow
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   489
on the bounded repetitions construct.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   490
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   491
In the work reported in \cite{CSL2022} and here, we add better support
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   492
for them. 
602
Chengsong
parents: 601
diff changeset
   493
The other repetition constructs include
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   494
$r^{\ldots m}$, $r^{n\ldots}$ and $r^{n\ldots m}$ which specify 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   495
intervals for how many times $r$ should match.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   496
$r^{\ldots m}$ means repeating
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   497
at most $m$ times, $r^{n\ldots}$ means repeating at least $n$ times and 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   498
$r^{n\ldots m}$ means repeating between $n$ and $m$ times.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   499
The results presented in this thesis extend straightforwardly to them
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   500
too. 
602
Chengsong
parents: 601
diff changeset
   501
Their formal definitions will be given later.
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   502
602
Chengsong
parents: 601
diff changeset
   503
Bounded repetitions are important because they
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   504
tend to occur often in practical use, for example in RegExLib,
602
Chengsong
parents: 601
diff changeset
   505
Snort, as well as in XML Schema definitions (XSDs).
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   506
According to Bj\"{o}rklund et al \cite{xml2015},
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   507
bounded regular expressions occur frequently in the latter and can have
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   508
counters up to ten million. An example XSD with a large counter they gave
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   509
was:
602
Chengsong
parents: 601
diff changeset
   510
\begin{verbatim}
Chengsong
parents: 601
diff changeset
   511
<sequence minOccurs="0" maxOccurs="65535">
Chengsong
parents: 601
diff changeset
   512
    <element name="TimeIncr" type="mpeg7:MediaIncrDurationType"/>
Chengsong
parents: 601
diff changeset
   513
    <element name="MotionParams" type="float" minOccurs="2" maxOccurs="12"/>
Chengsong
parents: 601
diff changeset
   514
</sequence>
Chengsong
parents: 601
diff changeset
   515
\end{verbatim}
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   516
This can be seen as the expression 
602
Chengsong
parents: 601
diff changeset
   517
$(ab^{2\ldots 12})^{0 \ldots 65535}$, where $a$ and $b$ are themselves
Chengsong
parents: 601
diff changeset
   518
regular expressions 
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   519
satisfying certain constraints (such as 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   520
satisfying the floating point number format).
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   521
The problem here is that tools based on the classic notion of
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   522
automata need to expand $r^{n}$ into $n$ connected 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   523
copies of the automaton for $r$. This leads to very inefficient matching
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   524
algorithms  or algorithms that consume large amounts of memory.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   525
A classic example is the regular expression $(a+b)^*  a (a+b)^{n}$
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   526
where the minimal DFA requires at least $2^{n+1}$ states (more on this
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   527
later).
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   528
Therefore regular expressions matching libraries that rely on the classic
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   529
notion of DFAs  often impose adhoc limits
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   530
for bounded regular expressions:
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   531
For example, in the regular expression matching library in the Go
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   532
language the regular expression $a^{1001}$ is not permitted, because no counter
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   533
can be above 1000, and in the built-in Rust regular expression library
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   534
expressions such as $a^{\{1000\}\{100\}\{5\}}$ give an error message
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   535
for being too big. These problems can of course be solved in matching algorithms where 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   536
automata go beyond the classic notion and for instance include explicit
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   537
counters \cite{Turo_ov__2020}.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   538
The point here is that Brzozowski derivatives and the algorithms by Sulzmann and Lu can be
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   539
straightforwardly extended to deal with bounded regular expressions
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   540
and moreover the resulting code still consists of only simple
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   541
recursive functions and inductive datatypes.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   542
Finally, bounded regular expressions do not destroy our finite
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   543
boundedness property, which we shall prove later on.
601
Chengsong
parents: 600
diff changeset
   544
604
Chengsong
parents: 603
diff changeset
   545
\section{Back-references and The Terminology Regex}
Chengsong
parents: 603
diff changeset
   546
Chengsong
parents: 603
diff changeset
   547
Chengsong
parents: 603
diff changeset
   548
Bounded repetitions, usually written in the form
Chengsong
parents: 603
diff changeset
   549
$r^{\{c\}}$ (where $c$ is a constant natural number),
Chengsong
parents: 603
diff changeset
   550
denotes a regular expression accepting strings
Chengsong
parents: 603
diff changeset
   551
that can be divided into $c$ substrings, where each 
Chengsong
parents: 603
diff changeset
   552
substring is in $r$. 
Chengsong
parents: 603
diff changeset
   553
For the regular expression $(a|b)^*a(a|b)^{\{2\}}$,
Chengsong
parents: 603
diff changeset
   554
an $\mathit{NFA}$ describing it would look like:
Chengsong
parents: 603
diff changeset
   555
\begin{center}
Chengsong
parents: 603
diff changeset
   556
\begin{tikzpicture}[shorten >=1pt,node distance=2cm,on grid,auto] 
Chengsong
parents: 603
diff changeset
   557
   \node[state,initial] (q_0)   {$q_0$}; 
Chengsong
parents: 603
diff changeset
   558
   \node[state, red] (q_1) [right=of q_0] {$q_1$}; 
Chengsong
parents: 603
diff changeset
   559
   \node[state, red] (q_2) [right=of q_1] {$q_2$}; 
Chengsong
parents: 603
diff changeset
   560
   \node[state, accepting, red](q_3) [right=of q_2] {$q_3$};
Chengsong
parents: 603
diff changeset
   561
    \path[->] 
Chengsong
parents: 603
diff changeset
   562
    (q_0) edge  node {a} (q_1)
Chengsong
parents: 603
diff changeset
   563
    	  edge [loop below] node {a,b} ()
Chengsong
parents: 603
diff changeset
   564
    (q_1) edge  node  {a,b} (q_2)
Chengsong
parents: 603
diff changeset
   565
    (q_2) edge  node  {a,b} (q_3);
Chengsong
parents: 603
diff changeset
   566
\end{tikzpicture}
Chengsong
parents: 603
diff changeset
   567
\end{center}
Chengsong
parents: 603
diff changeset
   568
The red states are "countdown states" which counts down 
Chengsong
parents: 603
diff changeset
   569
the number of characters needed in addition to the current
Chengsong
parents: 603
diff changeset
   570
string to make a successful match.
Chengsong
parents: 603
diff changeset
   571
For example, state $q_1$ indicates a match that has
Chengsong
parents: 603
diff changeset
   572
gone past the $(a|b)^*$ part of $(a|b)^*a(a|b)^{\{2\}}$,
Chengsong
parents: 603
diff changeset
   573
and just consumed the "delimiter" $a$ in the middle, and 
Chengsong
parents: 603
diff changeset
   574
need to match 2 more iterations of $(a|b)$ to complete.
Chengsong
parents: 603
diff changeset
   575
State $q_2$ on the other hand, can be viewed as a state
Chengsong
parents: 603
diff changeset
   576
after $q_1$ has consumed 1 character, and just waits
Chengsong
parents: 603
diff changeset
   577
for 1 more character to complete.
Chengsong
parents: 603
diff changeset
   578
$q_3$ is the last state, requiring 0 more character and is accepting.
Chengsong
parents: 603
diff changeset
   579
Depending on the suffix of the
Chengsong
parents: 603
diff changeset
   580
input string up to the current read location,
Chengsong
parents: 603
diff changeset
   581
the states $q_1$ and $q_2$, $q_3$
Chengsong
parents: 603
diff changeset
   582
may or may
Chengsong
parents: 603
diff changeset
   583
not be active, independent from each other.
Chengsong
parents: 603
diff changeset
   584
A $\mathit{DFA}$ for such an $\mathit{NFA}$ would
Chengsong
parents: 603
diff changeset
   585
contain at least $2^3$ non-equivalent states that cannot be merged, 
Chengsong
parents: 603
diff changeset
   586
because the subset construction during determinisation will generate
Chengsong
parents: 603
diff changeset
   587
all the elements in the power set $\mathit{Pow}\{q_1, q_2, q_3\}$.
Chengsong
parents: 603
diff changeset
   588
Generalizing this to regular expressions with larger
Chengsong
parents: 603
diff changeset
   589
bounded repetitions number, we have that
Chengsong
parents: 603
diff changeset
   590
regexes shaped like $r^*ar^{\{n\}}$ when converted to $\mathit{DFA}$s
Chengsong
parents: 603
diff changeset
   591
would require at least $2^{n+1}$ states, if $r$ contains
Chengsong
parents: 603
diff changeset
   592
more than 1 string.
Chengsong
parents: 603
diff changeset
   593
This is to represent all different 
Chengsong
parents: 603
diff changeset
   594
scenarios which "countdown" states are active.
Chengsong
parents: 603
diff changeset
   595
For those regexes, tools that uses $\DFA$s will get
Chengsong
parents: 603
diff changeset
   596
out of memory errors.
Chengsong
parents: 603
diff changeset
   597
Chengsong
parents: 603
diff changeset
   598
603
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   599
The time cost of regex matching algorithms in general
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   600
involve two different phases, and different things can go differently wrong on 
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   601
these phases.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   602
$\DFA$s usually have problems in the first (construction) phase
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   603
, whereas $\NFA$s usually run into trouble
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   604
on the second phase.
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   605
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   606
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   607
\section{Error-prone POSIX Implementations}
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   608
The problems with practical implementations
370fe1dde7c7 more restructuring chap1
Chengsong
parents: 602
diff changeset
   609
of reare not limited to slowness on certain 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   610
cases. 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   611
Another thing about these libraries is that there
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   612
is no correctness guarantee.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   613
In some cases, they either fail to generate a lexing result when there exists a match,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   614
or give results that are inconsistent with the $\POSIX$ standard.
601
Chengsong
parents: 600
diff changeset
   615
A concrete example would be the regex
Chengsong
parents: 600
diff changeset
   616
\begin{center}
Chengsong
parents: 600
diff changeset
   617
	$(aba + ab + a)* \text{and the string} ababa$
Chengsong
parents: 600
diff changeset
   618
\end{center}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   619
The correct $\POSIX$ match for the above would be 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   620
with the entire string $ababa$, 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   621
split into two Kleene star iterations, $[ab] [aba]$ at positions
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   622
$[0, 2), [2, 5)$
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   623
respectively.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   624
But trying this out in regex101\parencite{regex101}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   625
with different language engines would yield 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   626
the same two fragmented matches: $[aba]$ at $[0, 3)$
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   627
and $a$ at $[4, 5)$.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   628
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   629
Kuklewicz\parencite{KuklewiczHaskell} commented that most regex libraries are not
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   630
correctly implementing the POSIX (maximum-munch)
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   631
rule of regular expression matching.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   632
601
Chengsong
parents: 600
diff changeset
   633
As Grathwohl\parencite{grathwohl2014crash} wrote,
Chengsong
parents: 600
diff changeset
   634
\begin{quote}
Chengsong
parents: 600
diff changeset
   635
	The POSIX strategy is more complicated than the 
Chengsong
parents: 600
diff changeset
   636
	greedy because of the dependence on information about 
Chengsong
parents: 600
diff changeset
   637
	the length of matched strings in the various subexpressions.
Chengsong
parents: 600
diff changeset
   638
\end{quote}
Chengsong
parents: 600
diff changeset
   639
%\noindent
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   640
To summarise the above, regular expressions are important.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   641
They are popular and programming languages' library functions
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   642
for them are very fast on non-catastrophic cases.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   643
But there are problems with current practical implementations.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   644
First thing is that the running time might blow up.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   645
The second problem is that they might be error-prone on certain
543
b2bea5968b89 thesis_thys
Chengsong
parents: 542
diff changeset
   646
very simple cases.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   647
In the next part of the chapter, we will look into reasons why 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   648
certain regex engines are running horribly slow on the "catastrophic"
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   649
cases and propose a solution that addresses both of these problems
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   650
based on Brzozowski and Sulzmann and Lu's work.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   651
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   652
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   653
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   654
\subsection{Different Phases of a Matching/Lexing Algorithm}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   655
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   656
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   657
Most lexing algorithms can be roughly divided into 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   658
two phases during its run.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   659
The first phase is the "construction" phase,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   660
in which the algorithm builds some  
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   661
suitable data structure from the input regex $r$, so that
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   662
it can be easily operated on later.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   663
We denote
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   664
the time cost for such a phase by $P_1(r)$.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   665
The second phase is the lexing phase, when the input string 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   666
$s$ is read and the data structure
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   667
representing that regex $r$ is being operated on. 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   668
We represent the time
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   669
it takes by $P_2(r, s)$.\\
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   670
For $\mathit{DFA}$,
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   671
we have $P_2(r, s) = O( |s| )$,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   672
because we take at most $|s|$ steps, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   673
and each step takes
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   674
at most one transition--
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   675
a deterministic-finite-automata
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   676
by definition has at most one state active and at most one
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   677
transition upon receiving an input symbol.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   678
But unfortunately in the  worst case
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   679
$P_1(r) = O(exp^{|r|})$. An example will be given later. 
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   680
For $\mathit{NFA}$s, we have $P_1(r) = O(|r|)$ if we do not unfold 
601
Chengsong
parents: 600
diff changeset
   681
expressions like $r^n$ into 
Chengsong
parents: 600
diff changeset
   682
\[
Chengsong
parents: 600
diff changeset
   683
	\underbrace{r \cdots r}_{\text{n copies of r}}.
Chengsong
parents: 600
diff changeset
   684
\]
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   685
The $P_2(r, s)$ is bounded by $|r|\cdot|s|$, if we do not backtrack.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   686
On the other hand, if backtracking is used, the worst-case time bound bloats
601
Chengsong
parents: 600
diff changeset
   687
to $|r| * 2^{|s|}$.
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   688
%on the input
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   689
%And when calculating the time complexity of the matching algorithm,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   690
%we are assuming that each input reading step requires constant time.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   691
%which translates to that the number of 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   692
%states active and transitions taken each time is bounded by a
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   693
%constant $C$.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   694
%But modern  regex libraries in popular language engines
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   695
% often want to support much richer constructs than just
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   696
% sequences and Kleene stars,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   697
%such as negation, intersection, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   698
%bounded repetitions and back-references.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   699
%And de-sugaring these "extended" regular expressions 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   700
%into basic ones might bloat the size exponentially.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   701
%TODO: more reference for exponential size blowup on desugaring. 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   702
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   703
\subsection{Why $\mathit{DFA}s$ can be slow in the first phase}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   704
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   705
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   706
The good things about $\mathit{DFA}$s is that once
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   707
generated, they are fast and stable, unlike
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   708
backtracking algorithms. 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   709
However, they do not scale well with bounded repetitions.
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   710
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   711
\subsubsection{Problems with Bounded Repetitions}
604
Chengsong
parents: 603
diff changeset
   712
Chengsong
parents: 603
diff changeset
   713
Chengsong
parents: 603
diff changeset
   714
Chengsong
parents: 603
diff changeset
   715
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   716
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   717
\subsubsection{Tools that uses $\mathit{DFA}$s}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   718
%TODO:more tools that use DFAs?
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   719
$\mathit{LEX}$ and $\mathit{JFLEX}$ are tools
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   720
in $C$ and $\mathit{JAVA}$ that generates $\mathit{DFA}$-based
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   721
lexers. The user provides a set of regular expressions
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   722
and configurations to such lexer generators, and then 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   723
gets an output program encoding a minimized $\mathit{DFA}$
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   724
that can be compiled and run. 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   725
When given the above countdown regular expression,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   726
a small number $n$ would result in a determinised automata
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   727
with millions of states.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   728
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   729
For this reason, regex libraries that support 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   730
bounded repetitions often choose to use the $\mathit{NFA}$ 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   731
approach.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   732
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   733
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   734
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   735
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   736
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   737
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   738
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   739
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   740
\subsection{Why $\mathit{NFA}$s can be slow in the second phase}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   741
When one constructs an $\NFA$ out of a regular expression
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   742
there is often very little to be done in the first phase, one simply 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   743
construct the $\NFA$ states based on the structure of the input regular expression.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   744
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   745
In the lexing phase, one can simulate the $\mathit{NFA}$ running in two ways:
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   746
one by keeping track of all active states after consuming 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   747
a character, and update that set of states iteratively.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   748
This can be viewed as a breadth-first-search of the $\mathit{NFA}$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   749
for a path terminating
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   750
at an accepting state.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   751
Languages like $\mathit{Go}$ and $\mathit{Rust}$ use this
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   752
type of $\mathit{NFA}$ simulation and guarantees a linear runtime
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   753
in terms of input string length.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   754
%TODO:try out these lexers
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   755
The other way to use $\mathit{NFA}$ for matching is choosing  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   756
a single transition each time, keeping all the other options in 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   757
a queue or stack, and backtracking if that choice eventually 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   758
fails. This method, often called a  "depth-first-search", 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   759
is efficient in a lot of cases, but could end up
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   760
with exponential run time.\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   761
%TODO:COMPARE java python lexer speed with Rust and Go
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   762
The reason behind backtracking algorithms in languages like
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   763
Java and Python is that they support back-references.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   764
\subsubsection{Back References}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   765
If we have a regular expression like this (the sequence
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   766
operator is omitted for brevity):
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   767
\begin{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   768
	$r_1(r_2(r_3r_4))$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   769
\end{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   770
We could label sub-expressions of interest 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   771
by parenthesizing them and giving 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   772
them a number by the order in which their opening parentheses appear.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   773
One possible way of parenthesizing and labelling is given below:
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   774
\begin{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   775
	$\underset{1}{(}r_1\underset{2}{(}r_2\underset{3}{(}r_3)\underset{4}{(}r_4)))$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   776
\end{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   777
$r_1r_2r_3r_4$, $r_1r_2r_3$, $r_3$, $r_4$ are labelled
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   778
by 1 to 4. $1$ would refer to the entire expression 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   779
$(r_1(r_2(r_3)(r_4)))$, $2$ referring to $r_2(r_3)(r_4)$, etc.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   780
These sub-expressions are called "capturing groups".
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   781
We can use the following syntax to denote that we want a string just matched by a 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   782
sub-expression (capturing group) to appear at a certain location again, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   783
exactly as it was:
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   784
\begin{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   785
$\ldots\underset{\text{i-th lparen}}{(}{r_i})\ldots 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   786
\underset{s_i \text{ which just matched} \;r_i}{\backslash i}$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   787
\end{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   788
The backslash and number $i$ are used to denote such 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   789
so-called "back-references".
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   790
Let $e$ be an expression made of regular expressions 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   791
and back-references. $e$ contains the expression $e_i$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   792
as its $i$-th capturing group.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   793
The semantics of back-reference can be recursively
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   794
written as:
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   795
\begin{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   796
	\begin{tabular}{c}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   797
		$L ( e \cdot \backslash i) = \{s @ s_i \mid s \in L (e)\quad s_i \in L(r_i)$\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   798
		$s_i\; \text{match of ($e$, $s$)'s $i$-th capturing group string}\}$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   799
	\end{tabular}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   800
\end{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   801
The concrete example
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   802
$((a|b|c|\ldots|z)^*)\backslash 1$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   803
would match the string like $\mathit{bobo}$, $\mathit{weewee}$ and etc.\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   804
Back-reference is a construct in the "regex" standard
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   805
that programmers found useful, but not exactly 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   806
regular any more.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   807
In fact, that allows the regex construct to express 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   808
languages that cannot be contained in context-free
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   809
languages either.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   810
For example, the back-reference $((a^*)b\backslash1 b \backslash 1$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   811
expresses the language $\{a^n b a^n b a^n\mid n \in \mathbb{N}\}$,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   812
which cannot be expressed by context-free grammars\parencite{campeanu2003formal}.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   813
Such a language is contained in the context-sensitive hierarchy
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   814
of formal languages. 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   815
Solving the back-reference expressions matching problem
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   816
is NP-complete\parencite{alfred2014algorithms} and a non-bactracking,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   817
efficient solution is not known to exist.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   818
%TODO:read a bit more about back reference algorithms
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   819
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   820
It seems that languages like Java and Python made the trade-off
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   821
to support back-references at the expense of having to backtrack,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   822
even in the case of regexes not involving back-references.\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   823
Summing these up, we can categorise existing 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   824
practical regex libraries into the ones  with  linear
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   825
time guarantees like Go and Rust, which impose restrictions
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   826
on the user input (not allowing back-references, 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   827
bounded repetitions cannot exceed 1000 etc.), and ones  
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   828
 that allows the programmer much freedom, but grinds to a halt
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   829
 in some non-negligible portion of cases.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   830
 %TODO: give examples such as RE2 GOLANG 1000 restriction, rust no repetitions 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   831
% For example, the Rust regex engine claims to be linear, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   832
% but does not support lookarounds and back-references.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   833
% The GoLang regex library does not support over 1000 repetitions.  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   834
% Java and Python both support back-references, but shows
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   835
%catastrophic backtracking behaviours on inputs without back-references(
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   836
%when the language is still regular).
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   837
 %TODO: test performance of Rust on (((((a*a*)b*)b){20})*)c  baabaabababaabaaaaaaaaababaaaababababaaaabaaabaaaaaabaabaabababaababaaaaaaaaababaaaababababaaaaaaaaaaaaac
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   838
 %TODO: verify the fact Rust does not allow 1000+ reps
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   839
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   840
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   841
So we have practical implementations 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   842
on regular expression matching/lexing which are fast
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   843
but do not come with any guarantees that it will not grind to a halt
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   844
or give wrong answers.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   845
Our goal is to have a regex lexing algorithm that comes with 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   846
\begin{itemize}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   847
\item
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   848
proven correctness 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   849
\item 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   850
proven non-catastrophic properties
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   851
\item
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   852
easy extensions to
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   853
constructs like 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   854
 bounded repetitions, negation,  lookarounds, and even back-references.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   855
 \end{itemize}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   856
 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   857
\section{Our Solution--Formal Specification of POSIX and Brzozowski Derivatives}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   858
We propose Brzozowski derivatives on regular expressions as
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   859
  a solution to this.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   860
In the last fifteen or so years, Brzozowski's derivatives of regular
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   861
expressions have sparked quite a bit of interest in the functional
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   862
programming and theorem prover communities.   
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   863
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   864
\subsection{Motivation}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   865
  
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   866
Derivatives give a simple solution
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   867
to the problem of matching a string $s$ with a regular
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   868
expression $r$: if the derivative of $r$ w.r.t.\ (in
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   869
succession) all the characters of the string matches the empty string,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   870
then $r$ matches $s$ (and {\em vice versa}).  
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   871
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   872
The beauty of
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   873
Brzozowski's derivatives \parencite{Brzozowski1964} is that they are neatly
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   874
expressible in any functional language, and easily definable and
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   875
reasoned about in theorem provers---the definitions just consist of
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   876
inductive datatypes and simple recursive functions. 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   877
And an algorithms based on it by 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   878
Suzmann and Lu  \parencite{Sulzmann2014} allows easy extension
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   879
to include  extended regular expressions and 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   880
 simplification of internal data structures 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   881
 eliminating the exponential behaviours.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   882
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   883
However, two difficulties with derivative-based matchers exist:
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   884
\subsubsection{Problems with Current Brzozowski Matchers}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   885
First, Brzozowski's original matcher only generates a yes/no answer
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   886
for whether a regular expression matches a string or not.  This is too
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   887
little information in the context of lexing where separate tokens must
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   888
be identified and also classified (for example as keywords
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   889
or identifiers).  Sulzmann and Lu~\cite{Sulzmann2014} overcome this
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   890
difficulty by cleverly extending Brzozowski's matching
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   891
algorithm. Their extended version generates additional information on
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   892
\emph{how} a regular expression matches a string following the POSIX
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   893
rules for regular expression matching. They achieve this by adding a
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   894
second ``phase'' to Brzozowski's algorithm involving an injection
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   895
function.  In our own earlier work, we provided the formal
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   896
specification of what POSIX matching means and proved in Isabelle/HOL
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   897
the correctness
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   898
of Sulzmann and Lu's extended algorithm accordingly
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   899
\cite{AusafDyckhoffUrban2016}.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   900
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   901
The second difficulty is that Brzozowski's derivatives can 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   902
grow to arbitrarily big sizes. For example if we start with the
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   903
regular expression $(a+aa)^*$ and take
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   904
successive derivatives according to the character $a$, we end up with
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   905
a sequence of ever-growing derivatives like 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   906
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   907
\def\ll{\stackrel{\_\backslash{} a}{\longrightarrow}}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   908
\begin{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   909
\begin{tabular}{rll}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   910
$(a + aa)^*$ & $\ll$ & $(\ONE + \ONE{}a) \cdot (a + aa)^*$\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   911
& $\ll$ & $(\ZERO + \ZERO{}a + \ONE) \cdot (a + aa)^* \;+\; (\ONE + \ONE{}a) \cdot (a + aa)^*$\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   912
& $\ll$ & $(\ZERO + \ZERO{}a + \ZERO) \cdot (a + aa)^* + (\ONE + \ONE{}a) \cdot (a + aa)^* \;+\; $\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   913
& & $\qquad(\ZERO + \ZERO{}a + \ONE) \cdot (a + aa)^* + (\ONE + \ONE{}a) \cdot (a + aa)^*$\\
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   914
& $\ll$ & \ldots \hspace{15mm}(regular expressions of sizes 98, 169, 283, 468, 767, \ldots)
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   915
\end{tabular}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   916
\end{center}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   917
 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   918
\noindent where after around 35 steps we run out of memory on a
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   919
typical computer (we shall define shortly the precise details of our
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   920
regular expressions and the derivative operation).  Clearly, the
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   921
notation involving $\ZERO$s and $\ONE$s already suggests
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   922
simplification rules that can be applied to regular regular
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   923
expressions, for example $\ZERO{}\,r \Rightarrow \ZERO$, $\ONE{}\,r
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   924
\Rightarrow r$, $\ZERO{} + r \Rightarrow r$ and $r + r \Rightarrow
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   925
r$. While such simple-minded simplifications have been proved in our
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   926
earlier work to preserve the correctness of Sulzmann and Lu's
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   927
algorithm \cite{AusafDyckhoffUrban2016}, they unfortunately do
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   928
\emph{not} help with limiting the growth of the derivatives shown
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   929
above: the growth is slowed, but the derivatives can still grow rather
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   930
quickly beyond any finite bound.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   931
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   932
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   933
Sulzmann and Lu overcome this ``growth problem'' in a second algorithm
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   934
\cite{Sulzmann2014} where they introduce bit-coded
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   935
regular expressions. In this version, POSIX values are
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   936
represented as bit sequences and such sequences are incrementally generated
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   937
when derivatives are calculated. The compact representation
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   938
of bit sequences and regular expressions allows them to define a more
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   939
``aggressive'' simplification method that keeps the size of the
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   940
derivatives finite no matter what the length of the string is.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   941
They make some informal claims about the correctness and linear behaviour
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   942
of this version, but do not provide any supporting proof arguments, not
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   943
even ``pencil-and-paper'' arguments. They write about their bit-coded
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   944
\emph{incremental parsing method} (that is the algorithm to be formalised
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   945
in this dissertation)
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   946
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   947
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   948
  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   949
  \begin{quote}\it
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   950
  ``Correctness Claim: We further claim that the incremental parsing
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   951
  method [..] in combination with the simplification steps [..]
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   952
  yields POSIX parse trees. We have tested this claim
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   953
  extensively [..] but yet
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   954
  have to work out all proof details.'' \cite[Page 14]{Sulzmann2014}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   955
\end{quote}  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   956
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   957
Ausaf and Urban were able to back this correctness claim with
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   958
a formal proof.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   959
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   960
But as they stated,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   961
  \begin{quote}\it
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   962
The next step would be to implement a more aggressive simplification procedure on annotated regular expressions and then prove the corresponding algorithm generates the same values as blexer. Alas due to time constraints we are unable to do so here.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   963
\end{quote}  
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   964
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   965
This thesis implements the aggressive simplifications envisioned
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   966
by Ausaf and Urban,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   967
and gives a formal proof of the correctness with those simplifications.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   968
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   969
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   970
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   971
\section{Contribution}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   972
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   973
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   974
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   975
This work addresses the vulnerability of super-linear and
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   976
buggy regex implementations by the combination
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   977
of Brzozowski's derivatives and interactive theorem proving. 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   978
We give an 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   979
improved version of  Sulzmann and Lu's bit-coded algorithm using 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   980
derivatives, which come with a formal guarantee in terms of correctness and 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   981
running time as an Isabelle/HOL proof.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   982
Further improvements to the algorithm with an even stronger version of 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   983
simplification is made.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   984
We have not yet come up with one, but believe that it leads to a 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   985
formalised proof with a time bound linear to input and
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   986
cubic to regular expression size using a technique by
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   987
Antimirov\cite{Antimirov}.
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   988
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   989
 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   990
The main contribution of this thesis is 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   991
\begin{itemize}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   992
\item
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   993
a proven correct lexing algorithm
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   994
\item
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   995
with formalized finite bounds on internal data structures' sizes.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   996
\end{itemize}
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
   997
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   998
To our best knowledge, no lexing libraries using Brzozowski derivatives
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
   999
have a provable time guarantee, 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1000
and claims about running time are usually speculative and backed by thin empirical
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1001
evidence.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1002
%TODO: give references
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1003
For example, Sulzmann and Lu had proposed an algorithm  in which they
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1004
claim a linear running time.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1005
But that was falsified by our experiments and the running time 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1006
is actually $\Omega(2^n)$ in the worst case.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1007
A similar claim about a theoretical runtime of $O(n^2)$ is made for the Verbatim
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1008
%TODO: give references
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1009
lexer, which calculates POSIX matches and is based on derivatives.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1010
They formalized the correctness of the lexer, but not the complexity.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1011
In the performance evaluation section, they simply analyzed the run time
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1012
of matching $a$ with the string $\underbrace{a \ldots a}_{\text{n a's}}$
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1013
and concluded that the algorithm is quadratic in terms of input length.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1014
When we tried out their extracted OCaml code with our example $(a+aa)^*$,
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1015
the time it took to lex only 40 $a$'s was 5 minutes.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1016
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1017
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1018
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1019
\subsection{Related Work}
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1020
We are aware
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1021
of a mechanised correctness proof of Brzozowski's derivative-based matcher in HOL4 by
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1022
Owens and Slind~\parencite{Owens2008}. Another one in Isabelle/HOL is part
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1023
of the work by Krauss and Nipkow \parencite{Krauss2011}.  And another one
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1024
in Coq is given by Coquand and Siles \parencite{Coquand2012}.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1025
Also Ribeiro and Du Bois give one in Agda \parencite{RibeiroAgda2017}.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1026
 
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1027
 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1028
 When a regular expression does not behave as intended,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1029
people usually try to rewrite the regex to some equivalent form
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1030
or they try to avoid the possibly problematic patterns completely,
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1031
for which many false positives exist\parencite{Davis18}.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1032
Animated tools to "debug" regular expressions such as
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1033
 \parencite{regexploit2021} \parencite{regex101} are also popular.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1034
We are also aware of static analysis work on regular expressions that
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1035
aims to detect potentially expoential regex patterns. Rathnayake and Thielecke 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1036
\parencite{Rathnayake2014StaticAF} proposed an algorithm
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1037
that detects regular expressions triggering exponential
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1038
behavious on backtracking matchers.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1039
Weideman \parencite{Weideman2017Static} came up with 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1040
non-linear polynomial worst-time estimates
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1041
for regexes, attack string that exploit the worst-time 
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1042
scenario, and "attack automata" that generates
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1043
attack strings.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1044
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1045
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1046
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1047
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1048
\section{Structure of the thesis}
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1049
In chapter 2 \ref{Inj} we will introduce the concepts
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1050
and notations we 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1051
use for describing the lexing algorithm by Sulzmann and Lu,
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1052
and then give the lexing algorithm.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1053
We will give its variant in \ref{Bitcoded1}.
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1054
Then we illustrate in \ref{Bitcoded2}
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1055
how the algorithm without bitcodes falls short for such aggressive 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1056
simplifications and therefore introduce our version of the
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1057
 bit-coded algorithm and 
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1058
its correctness proof .  
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1059
In \ref{Finite} we give the second guarantee
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1060
of our bitcoded algorithm, that is a finite bound on the size of any 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1061
regex's derivatives.
538
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1062
In \ref{Cubic} we discuss stronger simplifications to improve the finite bound
8016a2480704 intro and chap2
Chengsong
parents: 537
diff changeset
  1063
in \ref{Finite} to a polynomial one, and demonstrate how one can extend the
532
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1064
algorithm to include constructs such as bounded repetitions and negations.
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1065
 
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1066
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1067
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1068
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1069
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1070
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1071
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1072
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1073
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1074
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1075
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1076
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1077
%----------------------------------------------------------------------------------------
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1078
cc54ce075db5 restructured
Chengsong
parents:
diff changeset
  1079