A short introduction to R

Outline

In this session, we review some of the fundamentals of the R language. It should be a useful refresher prior to the intermediate-level Data Analysis and Visualisation using R course.

Topics covered include:-

  • Creating variables
  • Using Functions
  • Vectors
  • Data frame
  • Subsetting data, the base R way
  • Plotting
  • Statistical testing
  • How to get help

For a more detailed introduction, we suggest the following free resources

R basics

Advantages of R

The R programming language is now recognised beyond the academic community as an effect solution for data analysis and visualisation. Notable users of R include:-

Key features

  • Open-source
  • Cross-platform
  • Access to existing visualisation / statistical tools
  • Flexibility
  • Visualisation and interactivity
  • Add-ons for many fields of research
  • Facilitating Reproducible Research
duke-scandal

duke-scandal

Two Biostatiscians (later termed ‘Forensic Bioinformaticians’) from M.D. Anderson used R extensively during their re-analysis and investigation of a Clinical Prognostication paper from Duke. The subsequent scandal put Reproducible Research at the forefront of everyone’s mind.

Keith Baggerly’s talk on the subject is highy-recommended.

Support for R

  • Online forums such as Stack Overflow regularly feature R
  • Blogs
  • Local user groups
  • e.g. Sheffield-R
  • Documentation via ? or help.start()
  • Documentation for packages is found via the Packages tab in the bottom-right of RStudio.
  • Packages analyse all kinds of Genomic data (>800)
  • Compulsory documentation (vignettes) for each package
  • 6-month release cycle
  • Course Materials
  • Example data and workflows
  • Common, re-usable framework and functionality
  • Available Support
    • Often you will be able to interact with the package maintainers / developers and other power-users of the project software

RStudio

  • Rstudio is a free environment for R
  • Convenient menus to access scripts, display plots
  • Still need to use command-line to get things done
  • Developed by some of the leading R programmers
  • Used by beginners, and experienced users alike

To get started, you will need to install the latest version of R and RStudio Desktop; both of which are free.

Once installed, you should be able to launch RStudio by clicking on its icon:-

Entering commands in R

  • The traditional way to enter R commands is via the Terminal, or using the console in RStudio (bottom-left panel when RStudio opens for first time).
  • this doesn’t automatically keep track of the steps you did
  • Alternative, an R script can be used to keep a record of the commands you used.
  • For this course we will use a relatively new feature called R markdown.
  • An R markdown mixes plain text with R code
  • The R code can be run from inside the document and the results are displayed directly underneath
  • Each chunk of R code looks something like this.
  • Each line of R can be executed by clicking on the line and pressing CTRL and ENTER
  • Or you can press the green triangle on the right-hand side to run everything in the chunk
  • Try this now!
print("Hello World")
[1] "Hello World"
  • You can add R chunks by pressing CRTL + ALT + I
    • or using the Insert menu option
    • (can also include code from other languages such as Python or bash)
    • try and avoid adding code chunks manually

Getting started

At a basic level, we can use R as a calculator to compute simple sums with the +, -, * (for multiplication) and / (for division) symbols.

2 + 2
[1] 4
2 - 2
[1] 0
4 * 3
[1] 12
10 / 2
[1] 5

The answer is displayed at the console with a [1] in front of it. The 1 inside the square brackets is a place-holder to signify how many values were in the answer (in this case only one). We will talk about dealing with lists of numbers shortly…

In the case of expressions involving multiple operations, R respects the BODMAS system to decide the order in which operations should be performed.

2 + 2 *3
[1] 8
2 + (2 * 3)
[1] 8
(2 + 2) * 3
[1] 12

R is capable of more complicated arithmetic such as trigonometry and logarithms; like you would find on a fancy scientific calculator. Of course, R also has a plethora of statistical operations as we will see.

pi
[1] 3.141593
sin (pi/2)
[1] 1
cos(pi)
[1] -1
tan(2)
[1] -2.18504
log(1)
[1] 0

We can only go so far with performing simple calculations like this. Eventually we will need to store our results for later use. For this, we need to make use of variables.

Variables

A variable is a letter or word which takes (or contains) a value. We use the assignment ‘operator’, <- to create a variable and store some value in it.

x <- 10
x
[1] 10
myNumber <- 25
myNumber
[1] 25

We also can perform arithmetic on variables using functions:

sqrt(myNumber)
[1] 5

We can add variables together:

x + myNumber
[1] 35

We can change the value of an existing variable:

x <- 21
x
[1] 21
  • We can set one variable to equal the value of another variable:
x <- myNumber
x
[1] 25
  • We can modify the contents of a variable:
myNumber <- myNumber + sqrt(16)
myNumber
[1] 29

When we are feeling lazy we might give our variables short names (x, y, i…etc), but a better practice would be to give them meaningful names. There are some restrictions on creating variable names. They cannot start with a number or contain characters such as ., _, ‘-’. Naming variables the same as in-built functions in R, such as c, T, mean should also be avoided.

Naming variables is a matter of taste. Some conventions exist such as a separating words with - or using camelCaps. Whatever convention you decided, stick with it!

Functions

Functions in R perform operations on arguments (the inputs(s) to the function). We have already used:

sin(x)
[1] -0.1323518

this returns the sine of x. In this case the function has one argument: x. Arguments are always contained in parentheses – curved brackets, () – separated by commas.

Arguments can be named or unnamed, but if they are unnamed they must be ordered (we will see later how to find the right order). The names of the arguments are determined by the author of the function and can be found in the help page for the function. When testing code, it is easier and safer to name the arguments. seq is a function for generating a numeric sequence from and to particular numbers. Type ?seq to get the help page for this function.

seq(from = 3, to = 20, by = 4)
[1]  3  7 11 15 19
seq(3, 20, 4)
[1]  3  7 11 15 19

Arguments can have default values, meaning we do not need to specify values for these in order to run the function.

rnorm is a function that will generate a series of values from a normal distribution. In order to use the function, we need to tell R how many values we want

## this will produce a random set of numbers, so everyone will get a different set of numbers
rnorm(n=10)
 [1]  1.07428564 -1.42125894  0.07065709  1.64828501 -1.43106387  0.87397931 -1.03087092 -0.69340405  0.50653689
[10]  0.85978011

The normal distribution is defined by a mean (average) and standard deviation (spread). However, in the above example we didn’t tell R what mean and standard deviation we wanted. So how does R know what to do? All arguments to a function and their default values are listed in the help page

(N.B sometimes help pages can describe more than one function)

?rnorm

In this case, we see that the defaults for mean and standard deviation are 0 and 1. We can change the function to generate values from a distribution with a different mean and standard deviation using the mean and sd arguments. It is important that we get the spelling of these arguments exactly right, otherwise R will an error message, or (worse?) do something unexpected.

rnorm(n=10, mean=2,sd=3)
 [1]  5.7418172  0.1905547 -3.8939599 -1.3003433  3.4895211  1.9100285  1.5689795 -0.1027642 -0.5908338  5.3734122
rnorm(10, 2, 3)
 [1] -5.6024243  1.6679810  5.1216143  4.5250889  2.8038471  6.0292955  1.3821019 -0.1843767 -3.7224487  4.5168876

In the examples above, seq and rnorm were both outputting a series of numbers, which is called a vector in R and is the most-fundamental data-type.




Exercise

  • What is the value of pi to 3 decimal places?
    • see the help for round ?round
  • How can we a create a sequence from 2 to 20 comprised of 5 equally-spaced numbers?
    • check the help page for seq ?seq
  • Create a variable containing 1000 random numbers with a mean of 2 and a standard deviation of 3
    • what is the maximum and minimum of these numbers?
    • what is the average?
    • HINT: see the help pages for functions min, max and `mean



Vectors

  • The basic data structure in R is a vector – an ordered collection of values.
  • R treats even single values as 1-element vectors.
  • The function c combines its arguments into a vector:
  • As c is a function, we specify it’s arguments in curved brackets(...)
x <- c(3,4,5,6)
x
[1] 3 4 5 6

The seq function we saw before was another example of how to create a sequence of values. A useful shortcut is to use the : symbol.

x <- 3:6
x
[1] 3 4 5 6

The square brackets [] indicate the position within the vector (the index). We can extract individual elements by using the [] notation:

x[1]
[1] 3
x[4]
[1] 6

We can even put a vector inside the square brackets: (vector indexing)




Exercise

Without using R!

  • If y <- 2:4, what would x[y] give?
    • [1] 3 5
    • [1] 2 4
    • [1] 4 5 6



When applying all standard arithmetic operations to vectors, application is element-wise. Thus, we say that R supports vectorised operations.

x <- 1:10
y <- x*2
y
 [1]  2  4  6  8 10 12 14 16 18 20
z <- x^2
x + y
 [1]  3  6  9 12 15 18 21 24 27 30

Vectorised operations are extremely powerful. Operations that would require a for loop (or similar) in other languages such as C, Python, can be performed in a single line of R code.

A vector can also contain text; called a character vector. Such a vector can also be constructed using the c function.

x <- c("A","B","C","D")

The quote marks are crucial. Why?

##try and ignore the eval=FALSE on the line above...we'll explain what this means later
x <- c(A, B, C, D)
Error in try(x <- c(A, B, C, D), silent = TRUE) : object 'A' not found

Another useful type of data that we will see is the logical or boolean which can take either the values of TRUE or FALSE

x <- c(TRUE,TRUE,FALSE)

Logical values are useful when we want to create subsets of our data. We can use comparison operators; ==, >, <, != to check if values are equal, greater than, less than, or not equal.

x <- c("A","A", "B","B","C")
x == "A"
[1]  TRUE  TRUE FALSE FALSE FALSE
x != "A"
[1] FALSE FALSE  TRUE  TRUE  TRUE
x <- rnorm(10)
x > 0
 [1] FALSE FALSE FALSE FALSE FALSE  TRUE  TRUE  TRUE  TRUE FALSE

However, all items in the vector must be the same type. If you attempt anything else, R will convert all values to the same (most basic) type.

x <- c(1, 2, "three")
x
[1] "1"     "2"     "three"

Packages in R

So far we have used functions that are available with the base distribution of R; the functions you get with a clean install of R. The open-source nature of R encourages others to write their own functions for their particular data-type or analyses.

Packages are distributed through repositories. The most-common ones are CRAN and Bioconductor. CRAN alone has many thousands of packages.

The Packages tab in the bottom-right panel of RStudio lists all packages that you currently have installed. Clicking on a package name will show a list of functions that available once that package has been loaded. The library function is used to load a package and make it’s functions / data available in your current R session. You need to do this every time you load a new RStudio session.

## RColorBrewer is a package for making nice colours
library(RColorBrewer)

There are functions for installing packages within R. If your package is part of the main CRAN repository, you can use install.packages

We will be using the gapminder R package in this practical. To install it, we would do.

install.packages("RColorBrewer")

A package may have several dependancies; other R packages from which it uses functions or data types (re-using code from other packages is strongly-encouraged). If this is the case, the other R packages will be located and installed too.

So long as you stick with the same version of R, you won’t need to repeat this install process.

Dealing with data

We are going to explore some of the basic features of R using data from the gapminder project, which have been bundled into an R package. These data give various indicator variables for different countries around the world (life expectancy, population and Gross Domestic Product). We have saved these data as a .csv file to demonstrate how to import data into R.

You can download these data here. Right-click the link and save to somewhere on your computer that you wish to work from.

The working directory

Like other software (Word, Excel, Photoshop….), R has a default location where it will save files to and import data from. This is known as the working directory in R. You can query what R currently considers its working directory by doing:-

getwd()

N.B. Here, a set of open and closed brackets () is used to call the getwd function with no arguments.

We can also list the files in this directory with:-

list.files()

Any .csv file in the working directory can be imported into R by supplying the name of the file to the read.csv function and creating a new variable to store the result. A useful sanity check is the file.exists function which will print TRUE is the file can be found in the working directory.

file.exists("gapminder.csv")
[1] TRUE

If the file we want to read is not in the current working directory, we will have to write the path to the file; either relevant to the current working directory (e.g. the directory “up” from the current working directory, or in a sub-folder), or the full path. In an interactive session, you can do use file.choose to open a dialogue box. The path to the the file will then be displayed in R.

file.choose()

Assuming the file can be found, we can use read.csv to import. Other functions can be used to read tab-delimited files (read.delim) or a generic read.table function. A data frame object is created.

gapminder <- read.csv("gapminder.csv")

The data frame object in R allows us to work with “tabular” data, like we might be used to dealing with in Excel, where our data can be thought of having rows and columns. The values in each column have to all be of the same type (i.e. all numbers or all text).




Exercise

  • What are the dimensions of the data frame?
  • What columns are available?
  • HINT: see the dim, ncol, nrow and colnames functions



In Rstudio , you can view the contents of the data frame we have just created. This is useful for interactive exploration of the data, but not so useful for automation and scripting and analyses.

View(gapminder)

We should always check the data frame that we have created. Sometimes R will happily read data using an inappropriate function and create an object without raising an error. However, the data might be unsuable. Consider:-

test <- read.delim("gapminder.csv")
head(test)
dim(test)
[1] 1704    1

We can access the columns of a data frame by knowing the column name. TIP Use auto-complete with the TAB key to get the name of the column correct

gapminder$country

A vector (1-dimensional) is returned, the length of which is the same as the number of rows in the data frame. The vector could be stored as a variable and itself be subset or used in further calculations

The summary function is a useful way of summarising the data containing in each column. It will give information about the type of data (remember, data frames can have a mixture of numeric and character columns) and also an appropriate summary. For numeric columns, it will report some stats about the distribution of the data. For categorical data, it will report the different levels.

summary(gapminder)
        country        continent        year         lifeExp           pop              gdpPercap       
 Afghanistan:  12   Africa  :624   Min.   :1952   Min.   :23.60   Min.   :6.001e+04   Min.   :   241.2  
 Albania    :  12   Americas:300   1st Qu.:1966   1st Qu.:48.20   1st Qu.:2.794e+06   1st Qu.:  1202.1  
 Algeria    :  12   Asia    :396   Median :1980   Median :60.71   Median :7.024e+06   Median :  3531.8  
 Angola     :  12   Europe  :360   Mean   :1980   Mean   :59.47   Mean   :2.960e+07   Mean   :  7215.3  
 Argentina  :  12   Oceania : 24   3rd Qu.:1993   3rd Qu.:70.85   3rd Qu.:1.959e+07   3rd Qu.:  9325.5  
 Australia  :  12                  Max.   :2007   Max.   :82.60   Max.   :1.319e+09   Max.   :113523.1  
 (Other)    :1632                                                                                       



Exercise

  • Save the life expectancy and population as variables
    • what is the maximum life expectancy?
    • what is the smallest population?
    • create a new vector containing the life expectancy to the nearest whole number
    • create a new vector containing the populations expressed as millions of people
    • HINT:- min, max, round…..



Subsetting

A data frame can be subset using square brackes[] placed after the name of the data frame. As a data frame is a two-dimensional object, you need a row and column index, or vector indices.

gapminder[1,2]
gapminder[2,1]
gapminder[c(1,2,3),1]
gapminder[c(1,2,3),c(1,2,3)]

Note that the data frame is not altered we are just seeing what a subset of the data looks like and not changing the underlying data. If we wanted to do this, we would need to create a new variale.

gapminder

Should we wish to see all rows, or all columns, we can neglect either the row or column index

gapminder[1,]
gapminder[,1]

Just like subsetting a vector, the indices can be vectors containing multiple values

gapminder[1:3,1:2]
gapminder[seq(1,1704,length.out = 10),1:4]

A common shortcut is head which prints the first six rows of a data frame.

head(gapminder)

When subsetting entire rows you need to remember the , after the row indices. If you fail to do so, R may still return a result. However, it probably won’t be what you expected. Look what happens if you wanted to the first three rows but typed the following command

gapminder[1:3]

Rather than selecting rows based on their numeric index (as in the previous example) we can use what we call a logical test. This is a test that gives either a TRUE or FALSE result. When applied to subsetting, only rows with a TRUE result get returned.

For example we could compare the lifeExp variable to 40. The result is a vector of TRUE or FALSE; one for each row in the data frame

gapminder$lifeExp < 40

This R code can be put inside the square brackets to select rows of interest (those observations where the life expectancy variable is less than 40).

gapminder[gapminder$lifeExp < 40, ]

The , is important as this tells R to display all columns. If we wanted a subset of the columns we would put their indices after the ,

gapminder[gapminder$lifeExp < 40, 1:4]

Testing for equality can be done using ==. This will only give TRUE for entries that are exactly the same as the test string.

gapminder[gapminder$country == "Zambia",]

N.B. For partial matches, the grep function and / or regular expressions (if you know them) can be used.

gapminder[grep("land", gapminder$country),]

There are a couple of ways of testing for more than one text value. The first uses an or | statement. i.e. testing if the value of country is Zambia or the value is Zimbabwe.

The %in% function is a convenient function for testing which items in a vector correspond to a defined set of values.

gapminder[gapminder$country == "Zambia" | gapminder$country == "Zimbabwe",]
gapminder[gapminder$country %in% c("Zambia","Zimbabwe"),]

Similar to or, we can require that both tests are TRUE by using an and & operation. e.g. which years in Zambia had a life expectancy less than 40

gapminder[gapminder$country == "Zambia" & gapminder$lifeExp < 40,]

Finally, we have != for testing if something is not equal

gapminder[gapminder$continent != "Europe",]

You will sometimes see the which function used during subsetting. This is used to convert the logical (TRUE/FALSE) vector into a numeric vector that gives the positon of the TRUE values only

  • this is useful if you think your vector might have NA (missing) values
  • there are no NAvalues in gapminder, so we’ll fake an example
tmp <- gapminder
tmp$pop[1:10] <- NA
tmp[tmp$pop < 1e6,]
tmp[which(tmp$pop < 1e6),]



Exercise

  • Create a subset of the data where the population less than a million in the year 2002
  • Create a subset of the data where the life expectancy is less than 45 in the year 2007
    • which continents are these countries located in?
  • Which rows in the data frame correspond to the maximum life expectancy and smallest population that you found in the previous exercise?



Columns in the data frame can be modified, or new columns created

  • can use the $ operator to assign a value to a column that doesn’t currently exist
    • the vector on the right of the assignment <- must that a length equal to the number of rows in the data frame
  • can also overwrite existing columns
gapminder_extra <- gapminder
gapminder_extra$PopInMillions <- gapminder_extra$pop / 1000000
gapminder_extra$lifeExp <- round(gapminder_extra$lifeExp)
gapminder_extra

Ordering and sorting

A vector can be returned in sorted form using the sort function.

sort(countries)
sort(countries,decreasing = TRUE)

However, if we want to sort an entire data frame a different approach is needed. The trick is to use order. Rather than giving a sorted set of values, it will give sorted indices. These indices can then be used for a subset operation.

leastPop <- gapminder[order(gapminder$pop),]
head(leastPop)

We can even order by more than one condition

gapminder[order(gapminder$year, gapminder$country),]

A final point on data frames is that we can export them out of R once we have done our data processing.

byWealth <- gapminder[order(gapminder$gdpPercap,decreasing = TRUE),]
head(byWealth)
write.csv(byWealth, file="dataOrderedByWealth.csv")

Plotting and stats

All your favourite types of plot can be created in R

  • Simple plots are supported in the base distribution of R (what you get automatically when you download R).
    • boxplot, hist, barplot,… all of which are extensions of the basic plot function
  • Many different customisations are possible
    • colour, overlay points / text, legends, multi-panel figures
  • You need to think about how best to visualise your data
  • References..

Plots can be constructed from vectors of numeric data, such as the data we get from a particular column in a data frame

hist(gapminder$lifeExp)

Scatter plots of two variables require two arguments; one for the x and one for the y axis.

plot(gapminder$pop,gapminder$lifeExp)

Barplots are commonly-used for counts of categorical data

barplot(table(gapminder$continent))

Boxplots are good for visualising and comparing distributions. Here the ~ symbol sets up a formula, the effect of which is to put the categorical variable on the x axis and continuous variable on the y axis.

boxplot(gapminder$gdpPercap ~ gapminder$continent)

Lots of customisations are possible to enhance the appaerance of our plots. Not for the faint-hearted, the help pages ?plot and ?par give the full details. In short,

  • Axis labels, and titles can be specified as character strings.

  • R recognises many preset names as colours. To get a full list use colours()
  • Plotting characters can be specified using a pre-defined number:-

Putting it all together.

plot(gapminder$pop,gapminder$lifeExp,pch=16,
     col="red",ylab="Life Expectancy",
     xlab="Population",main="Life Expectancy trend with population")

The same customisations can be used for various plots:-

boxplot(gapminder$gdpPercap ~ gapminder$continent,
        col=c("red","orange","green","blue","purple"),
        main="GDP per-continent",
        xlab="Continent",
        ylab="GDP")

an also save plots to a file calling the pdf or png functions before executing the code to create the plot.

pdf("myLittlePlot.pdf")
barplot(table(gapminder$continent))
dev.off()
null device 
          1 

Any plots created in-between the pdf(..) and dev.off() lines will get saved to the named file. The dev.off() line is very important; without it you will not be able to view the plot you have created. pdf files are useful because you can create documents with multiple pages. Moreover, they can be imported into tools such as Adobe Illustrator to be incorporated with other graphics.

The canvas model

It is important to realise that base graphics in R uses a “canvas model” to create graphics. We can only overlay extra information on-top of an exising plot and cannot “undo” what is already drawn.

Let’s suppose we want to visualise and life expectancy and population of countries in Europe and Africa. First, create two datasets to represent European and African countries in the year 2002

euroData <- gapminder[gapminder$continent == "Europe" & gapminder$year == 2002,]
dim(euroData)
[1] 30  6
afrData <- gapminder[gapminder$continent == "Africa" & gapminder$year == 2002,]
dim(afrData)
[1] 52  6

We can start by plotting the life expectancy of the European countries as red dots.

plot(euroData$pop, euroData$lifeExp,col="red",
     pch=16,
     xlab="Population",
     ylab="Life Expectancy")

The points function can be used put extra points corresponding to African countries on the existing plot.

points(afrData$pop, afrData$lifeExp,col="blue",pch=16)

Wait, how many African countries did we have?

nrow(afrData)
[1] 52

The problem here is that the initial limits of the y axis were defined using the life expectancy range of the European data. We can only add points to the existing plotting window, so any African countries with life expectancy outside this range will not get displayed.

We can define the axes when we create the plot using xlim and ylim.

plot(euroData$pop, euroData$lifeExp,col="red",
     pch=16,
     xlab="Population",
     ylab="Life Expectancy",
     xlim=c(0,8e7),ylim=c(30,90))
points(afrData$pop, afrData$lifeExp,col="blue",pch=16)

Other useful functions for adding features to an existing plot include text, abline, grid, legend among others

Another useful trick for plotting is to take advantage of pre-existing colour palettes in R. The RColorBrewer package is a useful package for such palettes; many of which are friendly to those with visual impairments.

library(RColorBrewer)
display.brewer.all(colorblindFriendly = TRUE)

The brewer.pal function can return the names of n colours from one of the pre-defined palettes to be used as a col argument to a plotting function.

boxplot(gapminder$gdpPercap ~ gapminder$continent,col=brewer.pal(5,"Set2"),
        main="GDP per-continent",
        xlab="Continent",
        ylab="GDP")




Exercise

  • The plot of population versus GDP shows and obvious set of outliers
  • which countries do the points represent?
  • can you plot these points in a different colour?
  • use the abline function to draw a vertical line to separate the outliers from the rest of the plot
    • see below for what the graph is intended to look like



The col argument to plot doesn’t have to contain only one colour. We can use a vector that assigns a colour to each point to be plotted. In the following code we:-

  • create a subset of the data describing European and African countries in 2002
  • create a dummy vector that is just red repeated as many times as rows in the data frame
subset_afr_eur <- gapminder[gapminder$continent %in% c("Europe", "Africa") & gapminder$year == 2002,]
mycol <- rep("red",nrow(subset_afr_eur))
plot(subset_afr_eur$pop, subset_afr_eur$lifeExp,
     col=mycol,
     pch=16)

We can replace the items in the colour vector that correspond to an African country with a different value

  • we can now create the same plot as before, but only using the plot function once
mycol[which(subset_afr_eur$continent == "Africa")] <- "blue"
plot(subset_afr_eur$pop, subset_afr_eur$lifeExp,
     col=mycol,
     pch=16,
     xlab="Population",
     ylab="Life Expenctancy")

If we preferred, we could plot the data for European and African countries in separate plots side-by-side.

  • here we specify a layout of the plot using the mfrow plotting parameter
  • c(1,2) corresponds to 1 row and 2 columns
  • make sure you run the entire code chunk at once by pressing the green run button, or highlighting all the lines
  • running the code line-by-line won’t have the correct effect
par(mfrow=c(1,2))
plot(euroData$pop, euroData$lifeExp,col="red",
     pch=16,
     xlab="Population",
     ylab="Life Expectancy",
     main="European Countries",
    xlim=c(0,8e7),ylim=c(30,90))
plot(afrData$pop, afrData$lifeExp,col="blue",
     pch=16,
     xlab="Population",
     ylab="Life Expectancy",
     main="African Countries",
    xlim=c(0,8e7),ylim=c(30,90))

We can’t really have a run-through of the R language without at least mentioning statistics! However, like plotting it is a vast field. The main challenges are putting your data in the correct format (which we have covered here), and deciding which test to use (which R will not advise you on!)

The t.test function is probably the most fundamental statistical testing function in R, and can be adapted to many different situations. Full details are given in the help page ?t.test.

The life expectancy looks to be different between Europe and Africa

boxplot(gapminder$lifeExp ~ gapminder$continent)

The output from t.test can be used to judge if there is a statistically-significant difference in means

  • need to specify two vectors, which are the values we want to test for difference in means
    • they don’t need to contain the same number of values
t.test(euroData$lifeExp,afrData$lifeExp)

    Welch Two Sample t-test

data:  euroData$lifeExp and afrData$lifeExp
t = 16.318, df = 65.751, p-value < 2.2e-16
alternative hypothesis: true difference in means is not equal to 0
95 percent confidence interval:
 20.51515 26.23558
sample estimates:
mean of x mean of y 
 76.70060  53.32523 

Were our data not normally-distributed we could use wilcox.test, for example. Fortunately, most statistical tests can be accessed in a similar manner, so it is easy to switch between using different tests provided your data are in the correct format. To re-iterate, the skill is in choosing which test is appropriate.

R also has functionality for assessing correlation between sets of values. For example, there seems to be a relationship between a country’s wealth and life expenctancy:-

plot(euroData$gdpPercap,euroData$lifeExp)

This can be quantified by calculating the correlation. Commonly the \(R^2\) value is reported

cor(euroData$gdpPercap,euroData$lifeExp)
[1] 0.8545089
cor(euroData$gdpPercap,euroData$lifeExp)^2
[1] 0.7301854

A linear model can be used to assess the relationship, which we can overlay on the plot using the function abline. The coefficients of the model give the slope and intercept of the straight line

model <- lm(euroData$lifeExp~euroData$gdpPercap)
plot(euroData$gdpPercap,euroData$lifeExp)
abline(model)

model$coefficients
       (Intercept) euroData$gdpPercap 
      7.185885e+01       2.230016e-04 
LS0tCnRpdGxlOiAiUiBDcmFzaCBDb3Vyc2UiCmF1dGhvcjogIk1hcmsgRHVubmluZyIKZGF0ZTogJ2ByIGZvcm1hdChTeXMudGltZSgpLCAiTGFzdCBtb2RpZmllZDogJWQgJWIgJVkiKWAnCm91dHB1dDogCiAgaHRtbF9ub3RlYm9vazogCiAgICB0b2M6IHllcwogICAgdG9jX2Zsb2F0OiB5ZXMKLS0tCgoKIyBBIHNob3J0IGludHJvZHVjdGlvbiB0byBSCgojIyBPdXRsaW5lCgpJbiB0aGlzIHNlc3Npb24sIHdlIHJldmlldyBzb21lIG9mIHRoZSBmdW5kYW1lbnRhbHMgb2YgdGhlIFIgbGFuZ3VhZ2UuIEl0IHNob3VsZCBiZSBhIHVzZWZ1bCByZWZyZXNoZXIgcHJpb3IgdG8gdGhlIGludGVybWVkaWF0ZS1sZXZlbCBbRGF0YSBBbmFseXNpcyBhbmQgVmlzdWFsaXNhdGlvbiB1c2luZyBSXShodHRwOi8vYmlvaW5mb3JtYXRpY3MtY29yZS1zaGFyZWQtdHJhaW5pbmcuZ2l0aHViLmlvL3ItaW50ZXJtZWRpYXRlLykgY291cnNlLiAKClRvcGljcyBjb3ZlcmVkIGluY2x1ZGU6LSAKCi0gQ3JlYXRpbmcgdmFyaWFibGVzCi0gVXNpbmcgRnVuY3Rpb25zCi0gVmVjdG9ycwotIERhdGEgZnJhbWUKLSBTdWJzZXR0aW5nIGRhdGEsIHRoZSBiYXNlIFIgd2F5Ci0gUGxvdHRpbmcgCi0gU3RhdGlzdGljYWwgdGVzdGluZwotIEhvdyB0byBnZXQgaGVscAoKRm9yIGEgbW9yZSBkZXRhaWxlZCBpbnRyb2R1Y3Rpb24sIHdlIHN1Z2dlc3QgdGhlIGZvbGxvd2luZyAqKipmcmVlKioqIHJlc291cmNlcwoKLSBbU29sdmluZyBCaW9sb2dpY2FsIFByb2JsZW1zIHdpdGggUl0oaHR0cDovL2NhbWJpb3RyYWluaW5nLmdpdGh1Yi5pby9yLWludHJvLykKLSBbSW50cm9kdWN0aW9uIHRvIERhdGEgU2NpZW5jZSB3aXRoIFJdKGh0dHA6Ly9zaG9wLm9yZWlsbHkuY29tL3Byb2R1Y3QvMDYzNjkyMDAzNDgzNC5kbykKLSBbQ291cnNlcmEgY291cnNlIGluIFJdKGh0dHA6Ly9ibG9nLnJldm9sdXRpb25hbmFseXRpY3MuY29tLzIwMTIvMTIvY291cnNlcmEtdmlkZW9zLmh0bWwpCi0gW0JlZ2lubmVycyBJbnRyb2R1Y3Rpb24gdG8gUiBTdGF0aXN0aWNhbCBTb2Z0d2FyZV0oaHR0cDovL2JpdGVzaXplYmlvLmNvbS93ZWJpbmFyLzIwNjAwL2JlZ2lubmVycy1pbnRyb2R1Y3Rpb24tdG8tci1zdGF0aXN0aWNhbC1zb2Z0d2FyZS8pCi0gW1IgcHJvZ3JhbW1pbmcgd2lraV0oaHR0cHM6Ly9lbi53aWtpYm9va3Mub3JnL3dpa2kvUl9Qcm9ncmFtbWluZykKLSBbUXVpY2sgUl0oaHR0cDovL3d3dy5zdGF0bWV0aG9kcy5uZXQvKQoKIyBSIGJhc2ljcwoKIyMgQWR2YW50YWdlcyBvZiBSCgohW10oaW1hZ2VzL05ZVGltZXNfUl9BcnRpY2xlLnBuZykKClRoZSBSIHByb2dyYW1taW5nIGxhbmd1YWdlIGlzIG5vdyByZWNvZ25pc2VkIGJleW9uZCB0aGUgYWNhZGVtaWMgY29tbXVuaXR5IGFzIGFuIGVmZmVjdCBzb2x1dGlvbiBmb3IgZGF0YSBhbmFseXNpcyBhbmQgdmlzdWFsaXNhdGlvbi4gW05vdGFibGUgdXNlcnMgb2YgUl0oaHR0cDovL3d3dy5yZXZvbHV0aW9uYW5hbHl0aWNzLmNvbS9jb21wYW5pZXMtdXNpbmctcikgaW5jbHVkZTotIAoKLSBbRmFjZWJvb2tdKGh0dHA6Ly9ibG9nLnJldm9sdXRpb25hbmFseXRpY3MuY29tLzIwMTAvMTIvYW5hbHlzaXMtb2YtZmFjZWJvb2stc3RhdHVzLXVwZGF0ZXMuaHRtbCksCi0gW2dvb2dsZV0oaHR0cDovL2Jsb2cucmV2b2x1dGlvbmFuYWx5dGljcy5jb20vMjAwOS8wNS9nb29nbGUtdXNpbmctci10by1hbmFseXplLWVmZmVjdGl2ZW5lc3Mtb2YtdHYtYWRzLmh0bWwpLAotIFtNaWNyb3NvZnRdKGh0dHA6Ly9ibG9nLnJldm9sdXRpb25hbmFseXRpY3MuY29tLzIwMTQvMDUvbWljcm9zb2Z0LXVzZXMtci1mb3IteGJveC1tYXRjaG1ha2luZy5odG1sKSAod2hvIHJlY2VudGx5IFtpbnZlc3RlZF0oaHR0cDovL2Jsb2dzLm1pY3Jvc29mdC5jb20vYmxvZy8yMDE1LzAxLzIzL21pY3Jvc29mdC1hY3F1aXJlLXJldm9sdXRpb24tYW5hbHl0aWNzLWhlbHAtY3VzdG9tZXJzLWZpbmQtYmlnLWRhdGEtdmFsdWUtYWR2YW5jZWQtc3RhdGlzdGljYWwtYW5hbHlzaXMvKSBpbiBhIGNvbW1lcmljYWwgcHJvdmlkZXIgb2YgUikKLSBUaGUgW05ldyBZb3JrIFRpbWVzXShodHRwOi8vYmxvZy5yZXZvbHV0aW9uYW5hbHl0aWNzLmNvbS8yMDExLzAzL2hvdy10aGUtbmV3LXlvcmstdGltZXMtdXNlcy1yLWZvci1kYXRhLXZpc3VhbGl6YXRpb24uaHRtbCkuCi0gW0J1enpmZWVkXShodHRwOi8vYmxvZy5yZXZvbHV0aW9uYW5hbHl0aWNzLmNvbS8yMDE1LzEyL2J1enpmZWVkLXVzZXMtci1mb3ItZGF0YS1qb3VybmFsaXNtLmh0bWwpIHVzZSBSIGZvciBzb21lIG9mIHRoZWlyIHNlcmlvdXMgYXJ0aWNsZXMgYW5kIGhhdmUgbWFkZSB0aGUgY29kZSBbcHVibGljYWxseSBhdmFpbGFibGVdKGh0dHBzOi8vYnV6emZlZWRuZXdzLmdpdGh1Yi5pby8yMDE2LTA0LWZlZGVyYWwtc3VydmVpbGxhbmNlLXBsYW5lcy9hbmFseXNpcy5odG1sKQotIFRoZSBbTmV3IFplYWxhbmQgVG91cmlzdCBCb2FyZF0oaHR0cHM6Ly9tYmllbnouc2hpbnlhcHBzLmlvL3RvdXJpc21fZGFzaGJvYXJkX3Byb2QvKSBoYXZlIFIgcnVubmluZyBpbiB0aGUgYmFja2dyb3VuZCBvZiB0aGVpciB3ZWJzaXRlCi0gVGhlIEJCQyBtYWtlcyBjb2RlIGF2YWlsYWJsZSBmb3Igc29tZSBvZiB0aGVpciBzdG9yaWVzIChlLmcuIFtnZW5kZXIgYmlhcyBpbiBtdXNpYyBmZXN0aXZhbHNdKGh0dHBzOi8vZ2l0aHViLmNvbS9CQkMtRGF0YS1Vbml0L211c2ljLWZlc3RpdmFscykpCi0gW0FpcmJuYl0oaHR0cHM6Ly9tZWRpdW0uY29tL2FpcmJuYi1lbmdpbmVlcmluZy91c2luZy1yLXBhY2thZ2VzLWFuZC1lZHVjYXRpb24tdG8tc2NhbGUtZGF0YS1zY2llbmNlLWF0LWFpcmJuYi05MDZmYWE1OGUxMmQpCiFbXShodHRwczovL2Nkbi1pbWFnZXMtMi5tZWRpdW0uY29tL21heC8xMjAwLzEqQlRNYlZGaF9oemlKSmNhUTdUQlJ3Zy5wbmcpCgojIyBLZXkgZmVhdHVyZXMKCi0gT3Blbi1zb3VyY2UKLSBDcm9zcy1wbGF0Zm9ybQotIEFjY2VzcyB0byBleGlzdGluZyB2aXN1YWxpc2F0aW9uIC8gc3RhdGlzdGljYWwgdG9vbHMKLSBGbGV4aWJpbGl0eQotIFZpc3VhbGlzYXRpb24gYW5kIGludGVyYWN0aXZpdHkKLSBBZGQtb25zIGZvciBtYW55IGZpZWxkcyBvZiByZXNlYXJjaAotIEZhY2lsaXRhdGluZyAqKipSZXByb2R1Y2libGUgUmVzZWFyY2gqKioKCiFbZHVrZS1zY2FuZGFsXShpbWFnZXMvcmVwLXJlc2VhcmNoLW55dC5wbmcpCgpUd28gQmlvc3RhdGlzY2lhbnMgKGxhdGVyIHRlcm1lZCAnKkZvcmVuc2ljIEJpb2luZm9ybWF0aWNpYW5zKicpIGZyb20gTS5ELiBBbmRlcnNvbiB1c2VkIFIgZXh0ZW5zaXZlbHkgZHVyaW5nIHRoZWlyIHJlLWFuYWx5c2lzIGFuZCBpbnZlc3RpZ2F0aW9uIG9mIGEgQ2xpbmljYWwgUHJvZ25vc3RpY2F0aW9uIHBhcGVyIGZyb20gRHVrZS4gVGhlIHN1YnNlcXVlbnQgW3NjYW5kYWxdKGh0dHBzOi8vd3d3LnlvdXR1YmUuY29tL3dhdGNoP3Y9VzVzWlROUE1RUk0pIHB1dCBSZXByb2R1Y2libGUgUmVzZWFyY2ggYXQgdGhlIGZvcmVmcm9udCBvZiBldmVyeW9uZSdzIG1pbmQuCgpLZWl0aCBCYWdnZXJseSdzIHRhbGsgb24gdGhlIHN1YmplY3QgaXMgaGlnaHktcmVjb21tZW5kZWQuCgo8aWZyYW1lIHdpZHRoPSI0MjAiIGhlaWdodD0iMzE1IiBzcmM9Imh0dHBzOi8vd3d3LnlvdXR1YmUuY29tL2VtYmVkLzdnWUlzN3VZYk1vIiBmcmFtZWJvcmRlcj0iMCIgYWxsb3dmdWxsc2NyZWVuPjwvaWZyYW1lPgoKIyMgU3VwcG9ydCBmb3IgUgoKLSBPbmxpbmUgZm9ydW1zIHN1Y2ggYXMgW1N0YWNrIE92ZXJmbG93XShodHRwOi8vc3RhY2tvdmVyZmxvdy5jb20vcXVlc3Rpb25zL3RhZ2dlZC9yKSByZWd1bGFybHkgZmVhdHVyZSBSCi0gW0Jsb2dzXShodHRwOi8vd3d3LnItYmxvZ2dlcnMuY29tLykKLSBMb2NhbCB1c2VyIGdyb3VwcwogICsgZS5nLiBbU2hlZmZpZWxkLVJdKGh0dHBzOi8vd3d3Lm1lZXR1cC5jb20vU2hlZmZpZWxkUi1TaGVmZmllbGQtUi1Vc2Vycy1Hcm91cC8pCi0gRG9jdW1lbnRhdGlvbiB2aWEgYD9gIG9yIGBoZWxwLnN0YXJ0KClgCi0gRG9jdW1lbnRhdGlvbiBmb3IgcGFja2FnZXMgaXMgZm91bmQgdmlhIHRoZSBQYWNrYWdlcyB0YWIgaW4gdGhlIGJvdHRvbS1yaWdodCBvZiBSU3R1ZGlvLgoKCiFbXShpbWFnZXMvbG9nb19iaW9jb25kdWN0b3IucG5nKQoKLSAgUGFja2FnZXMgYW5hbHlzZSBhbGwga2luZHMgb2YgR2Vub21pYyBkYXRhICg+ODAwKQotIENvbXB1bHNvcnkgZG9jdW1lbnRhdGlvbiAoKnZpZ25ldHRlcyopIGZvciBlYWNoIHBhY2thZ2UKLSA2LW1vbnRoIHJlbGVhc2UgY3ljbGUKLSBbQ291cnNlIE1hdGVyaWFsc10oaHR0cDovL2Jpb2NvbmR1Y3Rvci5vcmcvaGVscC9jb3Vyc2UtbWF0ZXJpYWxzLykKLSBbRXhhbXBsZSBkYXRhXShodHRwOi8vYmlvY29uZHVjdG9yLm9yZy9wYWNrYWdlcy9yZWxlYXNlL0Jpb2NWaWV3cy5odG1sI19fX0V4cGVyaW1lbnREYXRhKSBhbmQgW3dvcmtmbG93c10oaHR0cDovL2Jpb2NvbmR1Y3Rvci5vcmcvaGVscC93b3JrZmxvd3MvKQotIENvbW1vbiwgcmUtdXNhYmxlIGZyYW1ld29yayBhbmQgZnVuY3Rpb25hbGl0eQotIFtBdmFpbGFibGUgU3VwcG9ydF0oaHR0cHM6Ly9zdXBwb3J0LmJpb2NvbmR1Y3Rvci5vcmcvKQogICAgKyBPZnRlbiB5b3Ugd2lsbCBiZSBhYmxlIHRvIGludGVyYWN0IHdpdGggdGhlIHBhY2thZ2UgbWFpbnRhaW5lcnMgLyBkZXZlbG9wZXJzIGFuZCBvdGhlciBwb3dlci11c2VycyBvZiB0aGUgcHJvamVjdCBzb2Z0d2FyZQoKICAKIyMgUlN0dWRpbwoKCgotIFJzdHVkaW8gaXMgYSBmcmVlIGVudmlyb25tZW50IGZvciBSCi0gQ29udmVuaWVudCBtZW51cyB0byBhY2Nlc3Mgc2NyaXB0cywgZGlzcGxheSBwbG90cwotIFN0aWxsIG5lZWQgdG8gdXNlICpjb21tYW5kLWxpbmUqIHRvIGdldCB0aGluZ3MgZG9uZQotIERldmVsb3BlZCBieSBzb21lIG9mIHRoZSBsZWFkaW5nIFIgcHJvZ3JhbW1lcnMKLSBVc2VkIGJ5IGJlZ2lubmVycywgYW5kIGV4cGVyaWVuY2VkIHVzZXJzIGFsaWtlCgpUbyBnZXQgc3RhcnRlZCwgeW91IHdpbGwgbmVlZCB0byBpbnN0YWxsIHRoZSBbbGF0ZXN0IHZlcnNpb24gb2YgUl0oaHR0cHM6Ly9jcmFuLnItcHJvamVjdC5vcmcvKSBhbmQgW1JTdHVkaW8gRGVza3RvcF0oaHR0cHM6Ly93d3cucnN0dWRpby5jb20vcHJvZHVjdHMvcnN0dWRpby9kb3dubG9hZDMvKTsgYm90aCBvZiB3aGljaCBhcmUgKioqZnJlZSoqKi4gCgpPbmNlIGluc3RhbGxlZCwgeW91IHNob3VsZCBiZSBhYmxlIHRvIGxhdW5jaCBSU3R1ZGlvIGJ5IGNsaWNraW5nIG9uIGl0cyBpY29uOi0KCgohW10oaHR0cDovL3d3dy5yc3R1ZGlvLmNvbS93cC1jb250ZW50L3VwbG9hZHMvMjAxNC8wMy9ibHVlLTEyNS5wbmcpCgojIyBFbnRlcmluZyBjb21tYW5kcyBpbiBSCgotIFRoZSB0cmFkaXRpb25hbCB3YXkgdG8gZW50ZXIgUiBjb21tYW5kcyBpcyB2aWEgdGhlIFRlcm1pbmFsLCBvciB1c2luZyB0aGUgY29uc29sZSBpbiBSU3R1ZGlvIChib3R0b20tbGVmdCBwYW5lbCB3aGVuIFJTdHVkaW8gb3BlbnMgZm9yIGZpcnN0IHRpbWUpLgogICsgdGhpcyBkb2Vzbid0IGF1dG9tYXRpY2FsbHkga2VlcCB0cmFjayBvZiB0aGUgc3RlcHMgeW91IGRpZAotIEFsdGVybmF0aXZlLCBhbiAqUiBzY3JpcHQqIGNhbiBiZSB1c2VkIHRvIGtlZXAgYSByZWNvcmQgb2YgdGhlIGNvbW1hbmRzIHlvdSB1c2VkLgotIEZvciB0aGlzIGNvdXJzZSB3ZSB3aWxsIHVzZSBhIHJlbGF0aXZlbHkgbmV3IGZlYXR1cmUgY2FsbGVkICpSIG1hcmtkb3duKi4KLSBBbiBSIG1hcmtkb3duIG1peGVzIHBsYWluIHRleHQgd2l0aCBSIGNvZGUKLSBUaGUgUiBjb2RlIGNhbiBiZSBydW4gZnJvbSBpbnNpZGUgdGhlIGRvY3VtZW50IGFuZCB0aGUgcmVzdWx0cyBhcmUgZGlzcGxheWVkIGRpcmVjdGx5IHVuZGVybmVhdGgKLSBFYWNoIGNodW5rIG9mIFIgY29kZSBsb29rcyBzb21ldGhpbmcgbGlrZSB0aGlzLgoKCmBgYHtyfQoKYGBgCgoKLSBFYWNoIGxpbmUgb2YgUiBjYW4gYmUgZXhlY3V0ZWQgYnkgY2xpY2tpbmcgb24gdGhlIGxpbmUgYW5kIHByZXNzaW5nIENUUkwgYW5kIEVOVEVSCi0gT3IgeW91IGNhbiBwcmVzcyB0aGUgZ3JlZW4gdHJpYW5nbGUgb24gdGhlIHJpZ2h0LWhhbmQgc2lkZSB0byBydW4gZXZlcnl0aGluZyBpbiB0aGUgY2h1bmsKLSBUcnkgdGhpcyBub3chCgpgYGB7cn0KcHJpbnQoIkhlbGxvIFdvcmxkIikKYGBgCgotIFlvdSBjYW4gYWRkIFIgY2h1bmtzIGJ5IHByZXNzaW5nIENSVEwgKyBBTFQgKyBJCiAgICArIG9yIHVzaW5nIHRoZSBJbnNlcnQgbWVudSBvcHRpb24KICAgICsgKGNhbiBhbHNvIGluY2x1ZGUgY29kZSBmcm9tIG90aGVyIGxhbmd1YWdlcyBzdWNoIGFzIFB5dGhvbiBvciBiYXNoKQogICAgKyAqKnRyeSBhbmQgYXZvaWQgYWRkaW5nIGNvZGUgY2h1bmtzIG1hbnVhbGx5KioKCgojIEdldHRpbmcgc3RhcnRlZAoKIVtdKGltYWdlcy8xMjhweC1TSEFSUF9FTFNJTUFURV9FTC1XMjIxLmpwZykKCkF0IGEgYmFzaWMgbGV2ZWwsIHdlIGNhbiB1c2UgUiBhcyBhIGNhbGN1bGF0b3IgdG8gY29tcHV0ZSBzaW1wbGUgc3VtcyB3aXRoIHRoZSBgK2AsIGAtYCwgYCpgIChmb3IgbXVsdGlwbGljYXRpb24pIGFuZCBgL2AgKGZvciBkaXZpc2lvbikgc3ltYm9scy4gCgpgYGB7cn0KMiArIDIKMiAtIDIKNCAqIDMKMTAgLyAyCmBgYAoKVGhlIGFuc3dlciBpcyBkaXNwbGF5ZWQgYXQgdGhlIGNvbnNvbGUgd2l0aCBhIGBbMV1gIGluIGZyb250IG9mIGl0LiBUaGUgYDFgIGluc2lkZSB0aGUgc3F1YXJlIGJyYWNrZXRzIGlzIGEgcGxhY2UtaG9sZGVyIHRvIHNpZ25pZnkgaG93IG1hbnkgdmFsdWVzIHdlcmUgaW4gdGhlIGFuc3dlciAoaW4gdGhpcyBjYXNlIG9ubHkgb25lKS4gV2Ugd2lsbCB0YWxrIGFib3V0IGRlYWxpbmcgd2l0aCBsaXN0cyBvZiBudW1iZXJzIHNob3J0bHkuLi4KCkluIHRoZSBjYXNlIG9mIGV4cHJlc3Npb25zIGludm9sdmluZyBtdWx0aXBsZSBvcGVyYXRpb25zLCBSIHJlc3BlY3RzIHRoZSBbQk9ETUFTXShodHRwczovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9PcmRlcl9vZl9vcGVyYXRpb25zI01uZW1vbmljcykgc3lzdGVtIHRvIGRlY2lkZSB0aGUgb3JkZXIgaW4gd2hpY2ggb3BlcmF0aW9ucyBzaG91bGQgYmUgcGVyZm9ybWVkLgoKYGBge3J9CjIgKyAyICozCjIgKyAoMiAqIDMpCigyICsgMikgKiAzCmBgYAoKUiBpcyBjYXBhYmxlIG9mIG1vcmUgY29tcGxpY2F0ZWQgYXJpdGhtZXRpYyBzdWNoIGFzIHRyaWdvbm9tZXRyeSBhbmQgbG9nYXJpdGhtczsgbGlrZSB5b3Ugd291bGQgZmluZCBvbiBhIGZhbmN5IHNjaWVudGlmaWMgY2FsY3VsYXRvci4gT2YgY291cnNlLCBSIGFsc28gaGFzIGEgcGxldGhvcmEgb2Ygc3RhdGlzdGljYWwgb3BlcmF0aW9ucyBhcyB3ZSB3aWxsIHNlZS4KCiFbXShpbWFnZXMvMTI4cHgtQ2FzaW8tZngxMTVFUy01NTY0LmpwZykKCmBgYHtyfQpwaQpzaW4gKHBpLzIpCmNvcyhwaSkKdGFuKDIpCmxvZygxKQpgYGAKCldlIGNhbiBvbmx5IGdvIHNvIGZhciB3aXRoIHBlcmZvcm1pbmcgc2ltcGxlIGNhbGN1bGF0aW9ucyBsaWtlIHRoaXMuIEV2ZW50dWFsbHkgd2Ugd2lsbCBuZWVkIHRvIHN0b3JlIG91ciByZXN1bHRzIGZvciBsYXRlciB1c2UuIEZvciB0aGlzLCB3ZSBuZWVkIHRvIG1ha2UgdXNlIG9mICp2YXJpYWJsZXMqLgoKIyMgVmFyaWFibGVzCgpBIHZhcmlhYmxlIGlzIGEgbGV0dGVyIG9yIHdvcmQgd2hpY2ggdGFrZXMgKG9yIGNvbnRhaW5zKSBhIHZhbHVlLiBXZQp1c2UgdGhlIGFzc2lnbm1lbnQgJ29wZXJhdG9yJywgYDwtYCB0byBjcmVhdGUgYSB2YXJpYWJsZSBhbmQgc3RvcmUgc29tZSB2YWx1ZSBpbiBpdC4gCgpgYGB7cn0KeCA8LSAxMAp4Cm15TnVtYmVyIDwtIDI1Cm15TnVtYmVyCmBgYApXZSBhbHNvIGNhbiBwZXJmb3JtIGFyaXRobWV0aWMgb24gdmFyaWFibGVzIHVzaW5nIGZ1bmN0aW9uczoKCmBgYHtyfQpzcXJ0KG15TnVtYmVyKQpgYGAKCldlIGNhbiBhZGQgdmFyaWFibGVzIHRvZ2V0aGVyOgpgYGB7cn0KeCArIG15TnVtYmVyCmBgYAoKCldlIGNhbiBjaGFuZ2UgdGhlIHZhbHVlIG9mIGFuIGV4aXN0aW5nIHZhcmlhYmxlOgoKYGBge3J9CnggPC0gMjEKeApgYGAKCi0gV2UgY2FuIHNldCBvbmUgdmFyaWFibGUgdG8gZXF1YWwgdGhlIHZhbHVlIG9mIGFub3RoZXIgdmFyaWFibGU6CgpgYGB7cn0KeCA8LSBteU51bWJlcgp4CmBgYAoKLSBXZSBjYW4gbW9kaWZ5IHRoZSBjb250ZW50cyBvZiBhIHZhcmlhYmxlOgoKYGBge3J9Cm15TnVtYmVyIDwtIG15TnVtYmVyICsgc3FydCgxNikKbXlOdW1iZXIKYGBgCgpXaGVuIHdlIGFyZSBmZWVsaW5nIGxhenkgd2UgbWlnaHQgZ2l2ZSBvdXIgdmFyaWFibGVzIHNob3J0IG5hbWVzIChgeGAsIGB5YCwgYGlgLi4uZXRjKSwgYnV0IGEgYmV0dGVyIHByYWN0aWNlIHdvdWxkIGJlIHRvIGdpdmUgdGhlbSBtZWFuaW5nZnVsIG5hbWVzLiBUaGVyZSBhcmUgc29tZSByZXN0cmljdGlvbnMgb24gY3JlYXRpbmcgdmFyaWFibGUgbmFtZXMuIFRoZXkgY2Fubm90IHN0YXJ0IHdpdGggYSBudW1iZXIgb3IgY29udGFpbiBjaGFyYWN0ZXJzIHN1Y2ggYXMgYC5gLCBgX2AsICctJy4gTmFtaW5nIHZhcmlhYmxlcyB0aGUgc2FtZSBhcyBpbi1idWlsdCBmdW5jdGlvbnMgaW4gUiwgc3VjaCBhcyBgY2AsIGBUYCwgYG1lYW5gIHNob3VsZCBhbHNvIGJlIGF2b2lkZWQuCgpOYW1pbmcgdmFyaWFibGVzIGlzIGEgbWF0dGVyIG9mIHRhc3RlLiBTb21lIFtjb252ZW50aW9uc10oaHR0cDovL2Fkdi1yLmhhZC5jby5uei9TdHlsZS5odG1sKSBleGlzdCBzdWNoIGFzIGEgc2VwYXJhdGluZyB3b3JkcyB3aXRoIGAtYCBvciB1c2luZyAqYyphbWVsKkMqYXBzLiBXaGF0ZXZlciBjb252ZW50aW9uIHlvdSBkZWNpZGVkLCBzdGljayB3aXRoIGl0IQoKIyMgRnVuY3Rpb25zCgoqKkZ1bmN0aW9ucyoqIGluIFIgcGVyZm9ybSBvcGVyYXRpb25zIG9uICoqYXJndW1lbnRzKiogKHRoZSBpbnB1dHMocykgdG8gdGhlIGZ1bmN0aW9uKS4gV2UgaGF2ZSBhbHJlYWR5IHVzZWQ6CgpgYGB7cn0Kc2luKHgpCmBgYAoKdGhpcyByZXR1cm5zIHRoZSBzaW5lIG9mIHguIEluIHRoaXMgY2FzZSB0aGUgZnVuY3Rpb24gaGFzIG9uZSBhcmd1bWVudDogKip4KiouIEFyZ3VtZW50cyBhcmUgYWx3YXlzIGNvbnRhaW5lZCBpbiBwYXJlbnRoZXNlcyAtLSBjdXJ2ZWQgYnJhY2tldHMsICoqKCkqKiAtLSBzZXBhcmF0ZWQgYnkgY29tbWFzLgoKCkFyZ3VtZW50cyBjYW4gYmUgbmFtZWQgb3IgdW5uYW1lZCwgYnV0IGlmIHRoZXkgYXJlIHVubmFtZWQgdGhleSBtdXN0IGJlIG9yZGVyZWQgKHdlIHdpbGwgc2VlIGxhdGVyIGhvdyB0byBmaW5kIHRoZSByaWdodCBvcmRlcikuIFRoZSBuYW1lcyBvZiB0aGUgYXJndW1lbnRzIGFyZSBkZXRlcm1pbmVkIGJ5IHRoZSBhdXRob3Igb2YgdGhlIGZ1bmN0aW9uIGFuZCBjYW4gYmUgZm91bmQgaW4gdGhlIGhlbHAgcGFnZSBmb3IgdGhlIGZ1bmN0aW9uLiBXaGVuIHRlc3RpbmcgY29kZSwgaXQgaXMgZWFzaWVyIGFuZCBzYWZlciB0byBuYW1lIHRoZSBhcmd1bWVudHMuIGBzZXFgIGlzIGEgZnVuY3Rpb24gZm9yIGdlbmVyYXRpbmcgYSBudW1lcmljIHNlcXVlbmNlICpmcm9tKiBhbmQgKnRvKiBwYXJ0aWN1bGFyIG51bWJlcnMuIFR5cGUgYD9zZXFgIHRvIGdldCB0aGUgaGVscCBwYWdlIGZvciB0aGlzIGZ1bmN0aW9uLgoKYGBge3J9CnNlcShmcm9tID0gMywgdG8gPSAyMCwgYnkgPSA0KQpzZXEoMywgMjAsIDQpCmBgYAoKQXJndW1lbnRzIGNhbiBoYXZlICpkZWZhdWx0KiB2YWx1ZXMsIG1lYW5pbmcgd2UgZG8gbm90IG5lZWQgdG8gc3BlY2lmeSB2YWx1ZXMgZm9yIHRoZXNlIGluIG9yZGVyIHRvIHJ1biB0aGUgZnVuY3Rpb24uCgpgcm5vcm1gIGlzIGEgZnVuY3Rpb24gdGhhdCB3aWxsIGdlbmVyYXRlIGEgc2VyaWVzIG9mIHZhbHVlcyBmcm9tIGEgKm5vcm1hbCBkaXN0cmlidXRpb24qLiBJbiBvcmRlciB0byB1c2UgdGhlIGZ1bmN0aW9uLCB3ZSBuZWVkIHRvIHRlbGwgUiBob3cgbWFueSB2YWx1ZXMgd2Ugd2FudAoKYGBge3J9CiMjIHRoaXMgd2lsbCBwcm9kdWNlIGEgcmFuZG9tIHNldCBvZiBudW1iZXJzLCBzbyBldmVyeW9uZSB3aWxsIGdldCBhIGRpZmZlcmVudCBzZXQgb2YgbnVtYmVycwpybm9ybShuPTEwKQpgYGAKClRoZSBub3JtYWwgZGlzdHJpYnV0aW9uIGlzIGRlZmluZWQgYnkgYSAqbWVhbiogKGF2ZXJhZ2UpIGFuZCAqc3RhbmRhcmQgZGV2aWF0aW9uKiAoc3ByZWFkKS4gSG93ZXZlciwgaW4gdGhlIGFib3ZlIGV4YW1wbGUgd2UgZGlkbid0IHRlbGwgUiB3aGF0IG1lYW4gYW5kIHN0YW5kYXJkIGRldmlhdGlvbiB3ZSB3YW50ZWQuIFNvIGhvdyBkb2VzIFIga25vdyB3aGF0IHRvIGRvPyBBbGwgYXJndW1lbnRzIHRvIGEgZnVuY3Rpb24gYW5kIHRoZWlyIGRlZmF1bHQgdmFsdWVzIGFyZSBsaXN0ZWQgaW4gdGhlIGhlbHAgcGFnZQoKKCpOLkIgc29tZXRpbWVzIGhlbHAgcGFnZXMgY2FuIGRlc2NyaWJlIG1vcmUgdGhhbiBvbmUgZnVuY3Rpb24qKQoKYGBge3J9Cj9ybm9ybQpgYGAKCkluIHRoaXMgY2FzZSwgd2Ugc2VlIHRoYXQgdGhlIGRlZmF1bHRzIGZvciBtZWFuIGFuZCBzdGFuZGFyZCBkZXZpYXRpb24gYXJlIDAgYW5kIDEuIFdlIGNhbiBjaGFuZ2UgdGhlIGZ1bmN0aW9uIHRvIGdlbmVyYXRlIHZhbHVlcyBmcm9tIGEgZGlzdHJpYnV0aW9uIHdpdGggYSBkaWZmZXJlbnQgbWVhbiBhbmQgc3RhbmRhcmQgZGV2aWF0aW9uIHVzaW5nIHRoZSBgbWVhbmAgYW5kIGBzZGAgKmFyZ3VtZW50cyouIEl0IGlzIGltcG9ydGFudCB0aGF0IHdlIGdldCB0aGUgc3BlbGxpbmcgb2YgdGhlc2UgYXJndW1lbnRzIGV4YWN0bHkgcmlnaHQsIG90aGVyd2lzZSBSIHdpbGwgYW4gZXJyb3IgbWVzc2FnZSwgb3IgKHdvcnNlPykgZG8gc29tZXRoaW5nIHVuZXhwZWN0ZWQuCgpgYGB7cn0Kcm5vcm0obj0xMCwgbWVhbj0yLHNkPTMpCnJub3JtKDEwLCAyLCAzKQpgYGAKCkluIHRoZSBleGFtcGxlcyBhYm92ZSwgYHNlcWAgYW5kIGBybm9ybWAgd2VyZSBib3RoIG91dHB1dHRpbmcgYSBzZXJpZXMgb2YgbnVtYmVycywgd2hpY2ggaXMgY2FsbGVkIGEgKnZlY3RvciogaW4gUiBhbmQgaXMgdGhlIG1vc3QtZnVuZGFtZW50YWwgZGF0YS10eXBlLgoKCioqKioqKgoqKioqKioKKioqKioqCgoKCiMjIyBFeGVyY2lzZQoKCiAgLSBXaGF0IGlzIHRoZSB2YWx1ZSBvZiBgcGlgIHRvIDMgZGVjaW1hbCBwbGFjZXM/CiAgICArIHNlZSB0aGUgaGVscCBmb3IgYHJvdW5kYCBgP3JvdW5kYAogIC0gSG93IGNhbiB3ZSBhIGNyZWF0ZSBhIHNlcXVlbmNlIGZyb20gMiB0byAyMCBjb21wcmlzZWQgb2YgNSBlcXVhbGx5LXNwYWNlZCBudW1iZXJzPwogICAgKyBjaGVjayB0aGUgaGVscCBwYWdlIGZvciBzZXEgYD9zZXFgCiAgLSBDcmVhdGUgYSAqdmFyaWFibGUqIGNvbnRhaW5pbmcgMTAwMCByYW5kb20gbnVtYmVycyB3aXRoIGEgKm1lYW4qIG9mIDIgYW5kIGEgKnN0YW5kYXJkIGRldmlhdGlvbiogb2YgMwogICAgKyB3aGF0IGlzIHRoZSBtYXhpbXVtIGFuZCBtaW5pbXVtIG9mIHRoZXNlIG51bWJlcnM/CiAgICArIHdoYXQgaXMgdGhlIGF2ZXJhZ2U/CiAgICArIEhJTlQ6IHNlZSB0aGUgaGVscCBwYWdlcyBmb3IgZnVuY3Rpb25zIGBtaW5gLCBgbWF4YCBhbmQgYG1lYW4KICAgIApgYGB7cn0KCgpgYGAKICAgIAogICAgCioqKioqKgoqKioqKioKKioqKioqCgojIyBWZWN0b3JzCgotIFRoZSBiYXNpYyBkYXRhIHN0cnVjdHVyZSBpbiBSIGlzIGEgKip2ZWN0b3IqKiAtLSBhbiBvcmRlcmVkIGNvbGxlY3Rpb24gb2YgdmFsdWVzLiAKLSBSIHRyZWF0cyBldmVuIHNpbmdsZSB2YWx1ZXMgYXMgMS1lbGVtZW50IHZlY3RvcnMuIAotIFRoZSBmdW5jdGlvbiBgY2AgKmNvbWJpbmVzKiBpdHMgYXJndW1lbnRzIGludG8gYSB2ZWN0b3I6Ci0gQXMgYGNgIGlzIGEgZnVuY3Rpb24sIHdlIHNwZWNpZnkgaXQncyBhcmd1bWVudHMgaW4gY3VydmVkIGJyYWNrZXRzYCguLi4pYAoKYGBge3J9CnggPC0gYygzLDQsNSw2KQp4CmBgYAoKClRoZSBgc2VxYCBmdW5jdGlvbiB3ZSBzYXcgYmVmb3JlIHdhcyBhbm90aGVyIGV4YW1wbGUgb2YgaG93IHRvIGNyZWF0ZSBhIHNlcXVlbmNlIG9mIHZhbHVlcy4gQSB1c2VmdWwgc2hvcnRjdXQgaXMgdG8gdXNlIHRoZSBgOmAgc3ltYm9sLiAKCmBgYHtyfQp4IDwtIDM6Ngp4CmBgYAoKClRoZSBzcXVhcmUgYnJhY2tldHMgYFtdYCBpbmRpY2F0ZSB0aGUgcG9zaXRpb24gd2l0aGluIHRoZSB2ZWN0b3IgKHRoZSAqKippbmRleCoqKikuIFdlIGNhbiBleHRyYWN0IGluZGl2aWR1YWwgZWxlbWVudHMgYnkgdXNpbmcgdGhlIGBbXWAgbm90YXRpb246CgpgYGB7cn0KeFsxXQp4WzRdCmBgYAoKV2UgY2FuIGV2ZW4gcHV0IGEgdmVjdG9yIGluc2lkZSB0aGUgc3F1YXJlIGJyYWNrZXRzOiAoKnZlY3RvciBpbmRleGluZyopCgoKKioqKioqCioqKioqKgoqKioqKioKCiMjIyBFeGVyY2lzZQoqKldpdGhvdXQgdXNpbmcgUiEqKgoKICAtIElmIGB5IDwtIDI6NGAsIHdoYXQgd291bGQgYHhbeV1gIGdpdmU/CiAgICArIGBbMV0gIDMgIDUgYAogICAgKyBgWzFdICAyICA0YAogICAgKyBgWzFdICA0ICA1ICA2YAoKKioqKioqCioqKioqKgoqKioqKioKCgpXaGVuIGFwcGx5aW5nIGFsbCBzdGFuZGFyZCBhcml0aG1ldGljIG9wZXJhdGlvbnMgdG8gdmVjdG9ycywgYXBwbGljYXRpb24gaXMgZWxlbWVudC13aXNlLiBUaHVzLCB3ZSBzYXkgdGhhdCBSIHN1cHBvcnRzICp2ZWN0b3Jpc2VkKiBvcGVyYXRpb25zLgoKYGBge3J9CnggPC0gMToxMAp5IDwtIHgqMgp5CnogPC0geF4yCgp4ICsgeQpgYGAKClZlY3RvcmlzZWQgb3BlcmF0aW9ucyBhcmUgZXh0cmVtZWx5IHBvd2VyZnVsLiBPcGVyYXRpb25zIHRoYXQgd291bGQgcmVxdWlyZSBhICpmb3IqIGxvb3AgKG9yIHNpbWlsYXIpIGluIG90aGVyIGxhbmd1YWdlcyBzdWNoIGFzICoqQyoqLCAqKlB5dGhvbioqLCBjYW4gYmUgcGVyZm9ybWVkIGluIGEgc2luZ2xlIGxpbmUgb2YgUiBjb2RlLgoKQSB2ZWN0b3IgY2FuIGFsc28gY29udGFpbiB0ZXh0OyBjYWxsZWQgYSBjaGFyYWN0ZXIgdmVjdG9yLiBTdWNoIGEgdmVjdG9yIGNhbiBhbHNvIGJlIGNvbnN0cnVjdGVkIHVzaW5nIHRoZSBgY2AgZnVuY3Rpb24uIAoKYGBge3J9CnggPC0gYygiQSIsIkIiLCJDIiwiRCIpCmBgYAoKVGhlIHF1b3RlIG1hcmtzIGFyZSBjcnVjaWFsLiBXaHk/CgpgYGB7ciBldmFsPUZBTFNFfQojI3RyeSBhbmQgaWdub3JlIHRoZSBldmFsPUZBTFNFIG9uIHRoZSBsaW5lIGFib3ZlLi4ud2UnbGwgZXhwbGFpbiB3aGF0IHRoaXMgbWVhbnMgbGF0ZXIKeCA8LSBjKEEsIEIsIEMsIEQpCmBgYAoKYGBge3IgZWNobz1GQUxTRX0KIyMjIHlvdSBkb24ndCBuZWVkIHRvIHJ1biB0aGlzIGNvZGUKdHQgPC0gdHJ5KHggPC0gYyhBLCBCLCBDLCBEKSxzaWxlbnQgPSBUUlVFKQpjYXQodHQpCmBgYAoKCkFub3RoZXIgdXNlZnVsIHR5cGUgb2YgZGF0YSB0aGF0IHdlIHdpbGwgc2VlIGlzIHRoZSAqbG9naWNhbCogb3IgKmJvb2xlYW4qIHdoaWNoIGNhbiB0YWtlIGVpdGhlciB0aGUgdmFsdWVzIG9mIGBUUlVFYCBvciBgRkFMU0VgCgpgYGB7cn0KeCA8LSBjKFRSVUUsVFJVRSxGQUxTRSkKYGBgCgpMb2dpY2FsIHZhbHVlcyBhcmUgdXNlZnVsIHdoZW4gd2Ugd2FudCB0byBjcmVhdGUgc3Vic2V0cyBvZiBvdXIgZGF0YS4gV2UgY2FuIHVzZSAqY29tcGFyaXNvbiogb3BlcmF0b3JzOyBgPT1gLCBgPmAsIGA8YCwgYCE9YCB0byBjaGVjayBpZiB2YWx1ZXMgYXJlIGVxdWFsLCBncmVhdGVyIHRoYW4sIGxlc3MgdGhhbiwgb3Igbm90IGVxdWFsLgoKYGBge3J9CnggPC0gYygiQSIsIkEiLCAiQiIsIkIiLCJDIikKeCA9PSAiQSIKeCAhPSAiQSIKeCA8LSBybm9ybSgxMCkKeCA+IDAKYGBgCgpIb3dldmVyLCBhbGwgaXRlbXMgaW4gdGhlIHZlY3RvciAqKm11c3QqKiBiZSB0aGUgc2FtZSB0eXBlLiBJZiB5b3UgYXR0ZW1wdCBhbnl0aGluZyBlbHNlLCBSIHdpbGwgY29udmVydCBhbGwgdmFsdWVzIHRvIHRoZSBzYW1lIChtb3N0IGJhc2ljKSB0eXBlLgoKYGBge3J9CnggPC0gYygxLCAyLCAidGhyZWUiKQp4CmBgYAoKCgoKCiMjIFBhY2thZ2VzIGluIFIKClNvIGZhciB3ZSBoYXZlIHVzZWQgZnVuY3Rpb25zIHRoYXQgYXJlIGF2YWlsYWJsZSB3aXRoIHRoZSAqYmFzZSogZGlzdHJpYnV0aW9uIG9mIFI7IHRoZSBmdW5jdGlvbnMgeW91IGdldCB3aXRoIGEgY2xlYW4gaW5zdGFsbCBvZiBSLiBUaGUgb3Blbi1zb3VyY2UgbmF0dXJlIG9mIFIgZW5jb3VyYWdlcyBvdGhlcnMgdG8gd3JpdGUgdGhlaXIgb3duIGZ1bmN0aW9ucyBmb3IgdGhlaXIgcGFydGljdWxhciBkYXRhLXR5cGUgb3IgYW5hbHlzZXMuCgpQYWNrYWdlcyBhcmUgZGlzdHJpYnV0ZWQgdGhyb3VnaCAqcmVwb3NpdG9yaWVzKi4gVGhlIG1vc3QtY29tbW9uIG9uZXMgYXJlIENSQU4gYW5kIEJpb2NvbmR1Y3Rvci4gQ1JBTiBhbG9uZSBoYXMgbWFueSB0aG91c2FuZHMgb2YgcGFja2FnZXMuCgpUaGUgKipQYWNrYWdlcyoqIHRhYiBpbiB0aGUgYm90dG9tLXJpZ2h0IHBhbmVsIG9mIFJTdHVkaW8gbGlzdHMgYWxsIHBhY2thZ2VzIHRoYXQgeW91IGN1cnJlbnRseSBoYXZlIGluc3RhbGxlZC4gQ2xpY2tpbmcgb24gYSBwYWNrYWdlIG5hbWUgd2lsbCBzaG93IGEgbGlzdCBvZiBmdW5jdGlvbnMgdGhhdCBhdmFpbGFibGUgb25jZSB0aGF0IHBhY2thZ2UgaGFzIGJlZW4gbG9hZGVkLiBUaGUgYGxpYnJhcnlgIGZ1bmN0aW9uIGlzIHVzZWQgdG8gbG9hZCBhIHBhY2thZ2UgYW5kIG1ha2UgaXQncyBmdW5jdGlvbnMgLyBkYXRhIGF2YWlsYWJsZSBpbiB5b3VyIGN1cnJlbnQgUiBzZXNzaW9uLiAqWW91IG5lZWQgdG8gZG8gdGhpcyBldmVyeSB0aW1lIHlvdSBsb2FkIGEgbmV3IFJTdHVkaW8gc2Vzc2lvbiouIAoKCmBgYHtyIGV2YWw9RkFMU0V9CiMjIFJDb2xvckJyZXdlciBpcyBhIHBhY2thZ2UgZm9yIG1ha2luZyBuaWNlIGNvbG91cnMKbGlicmFyeShSQ29sb3JCcmV3ZXIpCmBgYAoKVGhlcmUgYXJlIGZ1bmN0aW9ucyBmb3IgaW5zdGFsbGluZyBwYWNrYWdlcyB3aXRoaW4gUi4gSWYgeW91ciBwYWNrYWdlIGlzIHBhcnQgb2YgdGhlIG1haW4gKipDUkFOKiogcmVwb3NpdG9yeSwgeW91IGNhbiB1c2UgYGluc3RhbGwucGFja2FnZXNgCgpXZSB3aWxsIGJlIHVzaW5nIHRoZSBgZ2FwbWluZGVyYCBSIHBhY2thZ2UgaW4gdGhpcyBwcmFjdGljYWwuIFRvIGluc3RhbGwgaXQsIHdlIHdvdWxkIGRvLgoKYGBge3IgZXZhbD1GQUxTRX0KaW5zdGFsbC5wYWNrYWdlcygiUkNvbG9yQnJld2VyIikKYGBgCgoKQSBwYWNrYWdlIG1heSBoYXZlIHNldmVyYWwgKmRlcGVuZGFuY2llcyo7IG90aGVyIFIgcGFja2FnZXMgZnJvbSB3aGljaCBpdCB1c2VzIGZ1bmN0aW9ucyBvciBkYXRhIHR5cGVzIChyZS11c2luZyBjb2RlIGZyb20gb3RoZXIgcGFja2FnZXMgaXMgc3Ryb25nbHktZW5jb3VyYWdlZCkuIElmIHRoaXMgaXMgdGhlIGNhc2UsIHRoZSBvdGhlciBSIHBhY2thZ2VzIHdpbGwgYmUgbG9jYXRlZCBhbmQgaW5zdGFsbGVkIHRvby4KCioqU28gbG9uZyBhcyB5b3Ugc3RpY2sgd2l0aCB0aGUgc2FtZSB2ZXJzaW9uIG9mIFIsIHlvdSB3b24ndCBuZWVkIHRvIHJlcGVhdCB0aGlzIGluc3RhbGwgcHJvY2Vzcy4qKgoKIyBEZWFsaW5nIHdpdGggZGF0YQoKV2UgYXJlIGdvaW5nIHRvIGV4cGxvcmUgc29tZSBvZiB0aGUgYmFzaWMgZmVhdHVyZXMgb2YgUiB1c2luZyBkYXRhIGZyb20gdGhlIFtnYXBtaW5kZXJdKGh0dHBzOi8vd3d3LmdhcG1pbmRlci5vcmcvZGF0YS8pIHByb2plY3QsIHdoaWNoIGhhdmUgYmVlbiBidW5kbGVkIGludG8gYW4gW1IgcGFja2FnZV0oaHR0cHM6Ly9naXRodWIuY29tL2plbm55YmMvZ2FwbWluZGVyKS4gVGhlc2UgZGF0YSBnaXZlIHZhcmlvdXMgaW5kaWNhdG9yIHZhcmlhYmxlcyBmb3IgZGlmZmVyZW50IGNvdW50cmllcyBhcm91bmQgdGhlIHdvcmxkIChsaWZlIGV4cGVjdGFuY3ksIHBvcHVsYXRpb24gYW5kIEdyb3NzIERvbWVzdGljIFByb2R1Y3QpLiBXZSBoYXZlIHNhdmVkIHRoZXNlIGRhdGEgYXMgYSBgLmNzdmAgZmlsZSB0byBkZW1vbnN0cmF0ZSBob3cgdG8gaW1wb3J0IGRhdGEgaW50byBSLgoKWW91IGNhbiBkb3dubG9hZCB0aGVzZSBkYXRhIFtoZXJlXShodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vYmlvaW5mb3JtYXRpY3MtY29yZS1zaGFyZWQtdHJhaW5pbmcvci1pbnRlcm1lZGlhdGUvbWFzdGVyL2dhcG1pbmRlci5jc3YpLiBSaWdodC1jbGljayB0aGUgbGluayBhbmQgc2F2ZSB0byBzb21ld2hlcmUgb24geW91ciBjb21wdXRlciB0aGF0IHlvdSB3aXNoIHRvIHdvcmsgZnJvbS4KCiMjIFRoZSB3b3JraW5nIGRpcmVjdG9yeQoKTGlrZSBvdGhlciBzb2Z0d2FyZSAoV29yZCwgRXhjZWwsIFBob3Rvc2hvcC4uLi4pLCBSIGhhcyBhIGRlZmF1bHQgbG9jYXRpb24gd2hlcmUgaXQgd2lsbCBzYXZlIGZpbGVzIHRvIGFuZCBpbXBvcnQgZGF0YSBmcm9tLiBUaGlzIGlzIGtub3duIGFzIHRoZSAqd29ya2luZyBkaXJlY3RvcnkqIGluIFIuIFlvdSBjYW4gcXVlcnkgd2hhdCBSIGN1cnJlbnRseSBjb25zaWRlcnMgaXRzIHdvcmtpbmcgZGlyZWN0b3J5IGJ5IGRvaW5nOi0KCmBgYHtyIGV2YWw9RkFMU0V9CmdldHdkKCkKYGBgCgoqTi5CLiBIZXJlLCBhIHNldCBvZiBvcGVuIGFuZCBjbG9zZWQgYnJhY2tldHMgYCgpYCBpcyB1c2VkIHRvIGNhbGwgdGhlIGBnZXR3ZGAgZnVuY3Rpb24gd2l0aCBubyBhcmd1bWVudHMuKgoKV2UgY2FuIGFsc28gbGlzdCB0aGUgZmlsZXMgaW4gdGhpcyBkaXJlY3Rvcnkgd2l0aDotCgpgYGB7fQpsaXN0LmZpbGVzKCkKYGBgCgpBbnkgYC5jc3ZgIGZpbGUgaW4gdGhlIHdvcmtpbmcgZGlyZWN0b3J5IGNhbiBiZSBpbXBvcnRlZCBpbnRvIFIgYnkgc3VwcGx5aW5nIHRoZSBuYW1lIG9mIHRoZSBmaWxlIHRvIHRoZSBgcmVhZC5jc3ZgIGZ1bmN0aW9uIGFuZCBjcmVhdGluZyBhIG5ldyB2YXJpYWJsZSB0byBzdG9yZSB0aGUgcmVzdWx0LiBBIHVzZWZ1bCBzYW5pdHkgY2hlY2sgaXMgdGhlIGBmaWxlLmV4aXN0c2AgZnVuY3Rpb24gd2hpY2ggd2lsbCBwcmludCBgVFJVRWAgaXMgdGhlIGZpbGUgY2FuIGJlIGZvdW5kIGluIHRoZSB3b3JraW5nIGRpcmVjdG9yeS4KCmBgYHtyfQpmaWxlLmV4aXN0cygiZ2FwbWluZGVyLmNzdiIpCmBgYAoKSWYgdGhlIGZpbGUgd2Ugd2FudCB0byByZWFkIGlzIG5vdCBpbiB0aGUgY3VycmVudCB3b3JraW5nIGRpcmVjdG9yeSwgd2Ugd2lsbCBoYXZlIHRvIHdyaXRlIHRoZSBwYXRoIHRvIHRoZSBmaWxlOyBlaXRoZXIgKnJlbGV2YW50KiB0byB0aGUgY3VycmVudCB3b3JraW5nIGRpcmVjdG9yeSAoZS5nLiB0aGUgZGlyZWN0b3J5ICJ1cCIgZnJvbSB0aGUgY3VycmVudCB3b3JraW5nIGRpcmVjdG9yeSwgb3IgaW4gYSBzdWItZm9sZGVyKSwgb3IgdGhlIGZ1bGwgcGF0aC4gSW4gYW4gaW50ZXJhY3RpdmUgc2Vzc2lvbiwgeW91IGNhbiBkbyB1c2UgYGZpbGUuY2hvb3NlYCB0byBvcGVuIGEgZGlhbG9ndWUgYm94LiBUaGUgcGF0aCB0byB0aGUgdGhlIGZpbGUgd2lsbCB0aGVuIGJlIGRpc3BsYXllZCBpbiBSLgoKYGBge3IgZXZhbD1GQUxTRX0KZmlsZS5jaG9vc2UoKQpgYGAKCkFzc3VtaW5nIHRoZSBmaWxlIGNhbiBiZSBmb3VuZCwgd2UgY2FuIHVzZSBgcmVhZC5jc3ZgIHRvIGltcG9ydC4gT3RoZXIgZnVuY3Rpb25zIGNhbiBiZSB1c2VkIHRvIHJlYWQgdGFiLWRlbGltaXRlZCBmaWxlcyAoYHJlYWQuZGVsaW1gKSBvciBhIGdlbmVyaWMgYHJlYWQudGFibGVgIGZ1bmN0aW9uLiBBIGRhdGEgZnJhbWUgb2JqZWN0IGlzIGNyZWF0ZWQuCgpgYGB7cn0KZ2FwbWluZGVyIDwtIHJlYWQuY3N2KCJnYXBtaW5kZXIuY3N2IikKYGBgCgpUaGUgZGF0YSBmcmFtZSBvYmplY3QgaW4gUiBhbGxvd3MgdXMgdG8gd29yayB3aXRoICJ0YWJ1bGFyIiBkYXRhLCBsaWtlIHdlIG1pZ2h0IGJlIHVzZWQgdG8gZGVhbGluZyB3aXRoIGluIEV4Y2VsLCB3aGVyZSBvdXIgZGF0YSBjYW4gYmUgdGhvdWdodCBvZiBoYXZpbmcgcm93cyBhbmQgY29sdW1ucy4gVGhlIHZhbHVlcyBpbiBlYWNoIGNvbHVtbiBoYXZlIHRvIGFsbCBiZSBvZiB0aGUgc2FtZSB0eXBlIChpLmUuIGFsbCBudW1iZXJzIG9yIGFsbCB0ZXh0KS4KCgoqKioqKioKKioqKioqCioqKioqKgoKCgojIyMgRXhlcmNpc2UKCi0gV2hhdCBhcmUgdGhlIGRpbWVuc2lvbnMgb2YgdGhlIGRhdGEgZnJhbWU/Ci0gV2hhdCBjb2x1bW5zIGFyZSBhdmFpbGFibGU/CiAgKyBISU5UOiBzZWUgdGhlIGBkaW1gLCBgbmNvbGAsIGBucm93YCBhbmQgYGNvbG5hbWVzYCBmdW5jdGlvbnMKICAKYGBge3J9CgoKCmBgYAogIAogCioqKioqKgoqKioqKioKKioqKioqCgoKCkluIFJzdHVkaW8gLCB5b3UgY2FuIHZpZXcgdGhlIGNvbnRlbnRzIG9mIHRoZSBkYXRhIGZyYW1lIHdlIGhhdmUganVzdCBjcmVhdGVkLiBUaGlzIGlzIHVzZWZ1bCBmb3IgaW50ZXJhY3RpdmUgZXhwbG9yYXRpb24gb2YgdGhlIGRhdGEsIGJ1dCBub3Qgc28gdXNlZnVsIGZvciBhdXRvbWF0aW9uIGFuZCBzY3JpcHRpbmcgYW5kIGFuYWx5c2VzLgoKYGBge3IgZXZhbD1GQUxTRX0KVmlldyhnYXBtaW5kZXIpCmBgYAoKV2Ugc2hvdWxkIGFsd2F5cyBjaGVjayB0aGUgZGF0YSBmcmFtZSB0aGF0IHdlIGhhdmUgY3JlYXRlZC4gU29tZXRpbWVzIFIgd2lsbCBoYXBwaWx5IHJlYWQgZGF0YSB1c2luZyBhbiBpbmFwcHJvcHJpYXRlIGZ1bmN0aW9uIGFuZCBjcmVhdGUgYW4gb2JqZWN0IHdpdGhvdXQgcmFpc2luZyBhbiBlcnJvci4gSG93ZXZlciwgdGhlIGRhdGEgbWlnaHQgYmUgdW5zdWFibGUuIENvbnNpZGVyOi0KCmBgYHtyfQp0ZXN0IDwtIHJlYWQuZGVsaW0oImdhcG1pbmRlci5jc3YiKQpoZWFkKHRlc3QpCmRpbSh0ZXN0KQpgYGAKCgpXZSBjYW4gYWNjZXNzIHRoZSBjb2x1bW5zIG9mIGEgZGF0YSBmcmFtZSBieSBrbm93aW5nIHRoZSBjb2x1bW4gbmFtZS4gCioqKlRJUCoqKiBVc2UgYXV0by1jb21wbGV0ZSB3aXRoIHRoZSAqKipUQUIqKioga2V5IHRvIGdldCB0aGUgbmFtZSBvZiB0aGUgY29sdW1uIGNvcnJlY3QKCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlciRjb3VudHJ5CgoKYGBgCgoKQSB2ZWN0b3IgKDEtZGltZW5zaW9uYWwpIGlzIHJldHVybmVkLCB0aGUgbGVuZ3RoIG9mIHdoaWNoIGlzIHRoZSBzYW1lIGFzIHRoZSBudW1iZXIgb2Ygcm93cyBpbiB0aGUgZGF0YSBmcmFtZS4gVGhlIHZlY3RvciBjb3VsZCBiZSBzdG9yZWQgYXMgYSB2YXJpYWJsZSBhbmQgaXRzZWxmIGJlIHN1YnNldCBvciB1c2VkIGluIGZ1cnRoZXIgY2FsY3VsYXRpb25zCgpgYGB7ciwgZWNobz1GQUxTRX0KY291bnRyaWVzIDwtIGdhcG1pbmRlciRjb3VudHJ5CmBgYAoKClRoZSBgc3VtbWFyeWAgZnVuY3Rpb24gaXMgYSB1c2VmdWwgd2F5IG9mIHN1bW1hcmlzaW5nIHRoZSBkYXRhIGNvbnRhaW5pbmcgaW4gZWFjaCBjb2x1bW4uIEl0IHdpbGwgZ2l2ZSBpbmZvcm1hdGlvbiBhYm91dCB0aGUgKnR5cGUqIG9mIGRhdGEgKHJlbWVtYmVyLCBkYXRhIGZyYW1lcyBjYW4gaGF2ZSBhIG1peHR1cmUgb2YgbnVtZXJpYyBhbmQgY2hhcmFjdGVyIGNvbHVtbnMpIGFuZCBhbHNvIGFuIGFwcHJvcHJpYXRlIHN1bW1hcnkuIEZvciBudW1lcmljIGNvbHVtbnMsIGl0IHdpbGwgcmVwb3J0IHNvbWUgc3RhdHMgYWJvdXQgdGhlIGRpc3RyaWJ1dGlvbiBvZiB0aGUgZGF0YS4gRm9yIGNhdGVnb3JpY2FsIGRhdGEsIGl0IHdpbGwgcmVwb3J0IHRoZSBkaWZmZXJlbnQgKmxldmVscyouCgpgYGB7cn0Kc3VtbWFyeShnYXBtaW5kZXIpCmBgYAoKCioqKioqKgoqKioqKioKKioqKioqCgojIyMgRXhlcmNpc2UKCi0gU2F2ZSB0aGUgbGlmZSBleHBlY3RhbmN5IGFuZCBwb3B1bGF0aW9uIGFzIHZhcmlhYmxlcwogICAgKyB3aGF0IGlzIHRoZSBtYXhpbXVtIGxpZmUgZXhwZWN0YW5jeT8KICAgICsgd2hhdCBpcyB0aGUgc21hbGxlc3QgcG9wdWxhdGlvbj8KICAgICsgY3JlYXRlIGEgbmV3IHZlY3RvciBjb250YWluaW5nIHRoZSBsaWZlIGV4cGVjdGFuY3kgdG8gdGhlIG5lYXJlc3Qgd2hvbGUgbnVtYmVyCiAgICArIGNyZWF0ZSBhIG5ldyB2ZWN0b3IgY29udGFpbmluZyB0aGUgcG9wdWxhdGlvbnMgZXhwcmVzc2VkIGFzIG1pbGxpb25zIG9mIHBlb3BsZQogICAgKyBISU5UOi0gYG1pbmAsIGBtYXhgLCBgcm91bmRgLi4uLi4KICAgIApgYGB7cn0KCmBgYAogICAgCiAgICAKKioqKioqCioqKioqKgoqKioqKioKCgoKIyMgU3Vic2V0dGluZwoKQSBkYXRhIGZyYW1lIGNhbiBiZSBzdWJzZXQgdXNpbmcgc3F1YXJlIGJyYWNrZXNgW11gIHBsYWNlZCBhZnRlciB0aGUgbmFtZSBvZiB0aGUgZGF0YSBmcmFtZS4gQXMgYSBkYXRhIGZyYW1lIGlzIGEgdHdvLWRpbWVuc2lvbmFsIG9iamVjdCwgeW91IG5lZWQgYSAqcm93KiBhbmQgKmNvbHVtbiogaW5kZXgsIG9yIHZlY3RvciBpbmRpY2VzLiAKCgoKCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlclsxLDJdCmdhcG1pbmRlclsyLDFdCmdhcG1pbmRlcltjKDEsMiwzKSwxXQpnYXBtaW5kZXJbYygxLDIsMyksYygxLDIsMyldCmBgYAoKKioqTm90ZSB0aGF0IHRoZSBkYXRhIGZyYW1lIGlzIG5vdCBhbHRlcmVkKioqIHdlIGFyZSBqdXN0IHNlZWluZyB3aGF0IGEgc3Vic2V0IG9mIHRoZSBkYXRhIGxvb2tzIGxpa2UgYW5kIG5vdCBjaGFuZ2luZyB0aGUgdW5kZXJseWluZyBkYXRhLiBJZiB3ZSB3YW50ZWQgdG8gZG8gdGhpcywgd2Ugd291bGQgbmVlZCB0byBjcmVhdGUgYSBuZXcgdmFyaWFsZS4KCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlcgpgYGAKCgoKU2hvdWxkIHdlIHdpc2ggdG8gc2VlIGFsbCByb3dzLCBvciBhbGwgY29sdW1ucywgd2UgY2FuIG5lZ2xlY3QgZWl0aGVyIHRoZSByb3cgb3IgY29sdW1uIGluZGV4CgpgYGB7ciBldmFsPUZBTFNFfQpnYXBtaW5kZXJbMSxdCmdhcG1pbmRlclssMV0KYGBgCgpKdXN0IGxpa2Ugc3Vic2V0dGluZyBhIHZlY3RvciwgdGhlIGluZGljZXMgY2FuIGJlIHZlY3RvcnMgY29udGFpbmluZyBtdWx0aXBsZSB2YWx1ZXMKCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlclsxOjMsMToyXQpnYXBtaW5kZXJbc2VxKDEsMTcwNCxsZW5ndGgub3V0ID0gMTApLDE6NF0KYGBgCgoKQSBjb21tb24gc2hvcnRjdXQgaXMgYGhlYWRgIHdoaWNoIHByaW50cyB0aGUgZmlyc3Qgc2l4IHJvd3Mgb2YgYSBkYXRhIGZyYW1lLgogICAKYGBge3J9CmhlYWQoZ2FwbWluZGVyKQpgYGAKCldoZW4gc3Vic2V0dGluZyBlbnRpcmUgcm93cyAqKip5b3UgbmVlZCB0byByZW1lbWJlciB0aGUgLCBhZnRlciB0aGUgcm93IGluZGljZXMqKiouIElmIHlvdSBmYWlsIHRvIGRvIHNvLCBSIG1heSBzdGlsbCByZXR1cm4gYSByZXN1bHQuIEhvd2V2ZXIsIGl0IHByb2JhYmx5IHdvbid0IGJlIHdoYXQgeW91IGV4cGVjdGVkLiBMb29rIHdoYXQgaGFwcGVucyBpZiB5b3Ugd2FudGVkIHRvIHRoZSBmaXJzdCB0aHJlZSByb3dzIGJ1dCB0eXBlZCB0aGUgZm9sbG93aW5nIGNvbW1hbmQKCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlclsxOjNdCmBgYAoKClJhdGhlciB0aGFuIHNlbGVjdGluZyByb3dzIGJhc2VkIG9uIHRoZWlyICpudW1lcmljKiBpbmRleCAoYXMgaW4gdGhlIHByZXZpb3VzIGV4YW1wbGUpIHdlIGNhbiB1c2Ugd2hhdCB3ZSBjYWxsIGEgKmxvZ2ljYWwgdGVzdCouIFRoaXMgaXMgYSB0ZXN0IHRoYXQgZ2l2ZXMgZWl0aGVyIGEgYFRSVUVgIG9yIGBGQUxTRWAgcmVzdWx0LiBXaGVuIGFwcGxpZWQgdG8gc3Vic2V0dGluZywgb25seSByb3dzIHdpdGggYSBgVFJVRWAgcmVzdWx0IGdldCByZXR1cm5lZC4KCkZvciBleGFtcGxlIHdlIGNvdWxkIGNvbXBhcmUgdGhlIGBsaWZlRXhwYCB2YXJpYWJsZSB0byA0MC4gVGhlIHJlc3VsdCBpcyBhICp2ZWN0b3IqIG9mIGBUUlVFYCBvciBgRkFMU0VgOyBvbmUgZm9yIGVhY2ggcm93IGluIHRoZSBkYXRhIGZyYW1lCgpgYGB7ciBldmFsPUZBTFNFfQpnYXBtaW5kZXIkbGlmZUV4cCA8IDQwCmBgYAoKVGhpcyBSIGNvZGUgY2FuIGJlIHB1dCBpbnNpZGUgdGhlIHNxdWFyZSBicmFja2V0cyB0byBzZWxlY3Qgcm93cyBvZiBpbnRlcmVzdCAodGhvc2Ugb2JzZXJ2YXRpb25zIHdoZXJlIHRoZSBsaWZlIGV4cGVjdGFuY3kgdmFyaWFibGUgaXMgbGVzcyB0aGFuIDQwKS4gCgpgYGB7ciBldmFsPUZBTFNFfQpnYXBtaW5kZXJbZ2FwbWluZGVyJGxpZmVFeHAgPCA0MCwgXQpgYGAKCgpUaGUgYCxgIGlzIGltcG9ydGFudCBhcyB0aGlzIHRlbGxzIFIgdG8gZGlzcGxheSBhbGwgY29sdW1ucy4gSWYgd2Ugd2FudGVkIGEgc3Vic2V0IG9mIHRoZSBjb2x1bW5zIHdlIHdvdWxkIHB1dCB0aGVpciBpbmRpY2VzIGFmdGVyIHRoZSBgLGAKCmBgYHtyIGV2YWw9RkFMU0V9CmdhcG1pbmRlcltnYXBtaW5kZXIkbGlmZUV4cCA8IDQwLCAxOjRdCmBgYAoKClRlc3RpbmcgZm9yIGVxdWFsaXR5IGNhbiBiZSBkb25lIHVzaW5nIGA9PWAuIFRoaXMgd2lsbCBvbmx5IGdpdmUgYFRSVUVgIGZvciBlbnRyaWVzIHRoYXQgYXJlICpleGFjdGx5KiB0aGUgc2FtZSBhcyB0aGUgdGVzdCBzdHJpbmcuIAoKYGBge3J9CmdhcG1pbmRlcltnYXBtaW5kZXIkY291bnRyeSA9PSAiWmFtYmlhIixdCgpgYGAKCk4uQi4gRm9yIHBhcnRpYWwgbWF0Y2hlcywgdGhlIGBncmVwYCBmdW5jdGlvbiBhbmQgLyBvciAqcmVndWxhciBleHByZXNzaW9ucyogKGlmIHlvdSBrbm93IHRoZW0pIGNhbiBiZSB1c2VkLgoKYGBge3IgZXZhbD1GQUxTRX0KZ2FwbWluZGVyW2dyZXAoImxhbmQiLCBnYXBtaW5kZXIkY291bnRyeSksXQpgYGAKCgpUaGVyZSBhcmUgYSBjb3VwbGUgb2Ygd2F5cyBvZiB0ZXN0aW5nIGZvciBtb3JlIHRoYW4gb25lIHRleHQgdmFsdWUuIFRoZSBmaXJzdCB1c2VzIGFuICpvciogYHxgIHN0YXRlbWVudC4gaS5lLiB0ZXN0aW5nIGlmIHRoZSB2YWx1ZSBvZiBgY291bnRyeWAgaXMgYFphbWJpYWAgKm9yKiB0aGUgdmFsdWUgaXMgYFppbWJhYndlYC4KClRoZSBgJWluJWAgZnVuY3Rpb24gaXMgYSBjb252ZW5pZW50IGZ1bmN0aW9uIGZvciB0ZXN0aW5nIHdoaWNoIGl0ZW1zIGluIGEgdmVjdG9yIGNvcnJlc3BvbmQgdG8gYSBkZWZpbmVkIHNldCBvZiB2YWx1ZXMuCgpgYGB7ciBldmFsPUZBTFNFfQpnYXBtaW5kZXJbZ2FwbWluZGVyJGNvdW50cnkgPT0gIlphbWJpYSIgfCBnYXBtaW5kZXIkY291bnRyeSA9PSAiWmltYmFid2UiLF0KZ2FwbWluZGVyW2dhcG1pbmRlciRjb3VudHJ5ICVpbiUgYygiWmFtYmlhIiwiWmltYmFid2UiKSxdCmBgYAoKYGBge3IgZWNobz1GQUxTRX0KaGVhZChnYXBtaW5kZXJbZ2FwbWluZGVyJGNvdW50cnkgPT0gIlphbWJpYSIgfCBnYXBtaW5kZXIkY291bnRyeSA9PSAiWmltYmFid2UiLF0pCmBgYAoKClNpbWlsYXIgdG8gKm9yKiwgd2UgY2FuIHJlcXVpcmUgdGhhdCBib3RoIHRlc3RzIGFyZSBgVFJVRWAgYnkgdXNpbmcgYW4gKmFuZCogYCZgIG9wZXJhdGlvbi4gZS5nLiB3aGljaCB5ZWFycyBpbiBaYW1iaWEgaGFkIGEgbGlmZSBleHBlY3RhbmN5IGxlc3MgdGhhbiA0MAoKYGBge3J9CmdhcG1pbmRlcltnYXBtaW5kZXIkY291bnRyeSA9PSAiWmFtYmlhIiAmIGdhcG1pbmRlciRsaWZlRXhwIDwgNDAsXQpgYGAKCkZpbmFsbHksIHdlIGhhdmUgYCE9YCBmb3IgdGVzdGluZyBpZiBzb21ldGhpbmcgaXMgKm5vdCogZXF1YWwKCmBgYHtyfQpnYXBtaW5kZXJbZ2FwbWluZGVyJGNvbnRpbmVudCAhPSAiRXVyb3BlIixdCmBgYAoKWW91IHdpbGwgc29tZXRpbWVzIHNlZSB0aGUgYHdoaWNoYCBmdW5jdGlvbiB1c2VkIGR1cmluZyBzdWJzZXR0aW5nLiBUaGlzIGlzIHVzZWQgdG8gY29udmVydCB0aGUgbG9naWNhbCAoYFRSVUUvRkFMU0VgKSB2ZWN0b3IgaW50byBhIG51bWVyaWMgdmVjdG9yIHRoYXQgZ2l2ZXMgdGhlIHBvc2l0b24gb2YgdGhlIGBUUlVFYCB2YWx1ZXMgb25seQoKLSB0aGlzIGlzIHVzZWZ1bCBpZiB5b3UgdGhpbmsgeW91ciB2ZWN0b3IgbWlnaHQgaGF2ZSBgTkFgICgqbWlzc2luZyopIHZhbHVlcyAKLSB0aGVyZSBhcmUgbm8gYE5BYHZhbHVlcyBpbiBgZ2FwbWluZGVyYCwgc28gd2UnbGwgZmFrZSBhbiBleGFtcGxlCgpgYGB7cn0KdG1wIDwtIGdhcG1pbmRlcgp0bXAkcG9wWzE6MTBdIDwtIE5BCnRtcFt0bXAkcG9wIDwgMWU2LF0KdG1wW3doaWNoKHRtcCRwb3AgPCAxZTYpLF0KYGBgCgoKKioqKioqCioqKioqKgoqKioqKioKCiMjIyBFeGVyY2lzZQoKLSBDcmVhdGUgYSBzdWJzZXQgb2YgdGhlIGRhdGEgd2hlcmUgdGhlIHBvcHVsYXRpb24gbGVzcyB0aGFuIGEgbWlsbGlvbiBpbiB0aGUgeWVhciAyMDAyCi0gQ3JlYXRlIGEgc3Vic2V0IG9mIHRoZSBkYXRhIHdoZXJlIHRoZSBsaWZlIGV4cGVjdGFuY3kgaXMgbGVzcyB0aGFuIDQ1IGluIHRoZSB5ZWFyIDIwMDcKICAgICsgd2hpY2ggY29udGluZW50cyBhcmUgdGhlc2UgY291bnRyaWVzIGxvY2F0ZWQgaW4/Ci0gV2hpY2ggcm93cyBpbiB0aGUgZGF0YSBmcmFtZSBjb3JyZXNwb25kIHRvIHRoZSAqbWF4aW11bSBsaWZlIGV4cGVjdGFuY3kqIGFuZCAqc21hbGxlc3QgcG9wdWxhdGlvbiogdGhhdCB5b3UgZm91bmQgaW4gdGhlIHByZXZpb3VzIGV4ZXJjaXNlPwoKYGBge3J9CgoKYGBgCgoKCioqKioqKgoqKioqKioKKioqKioqCgoKQ29sdW1ucyBpbiB0aGUgZGF0YSBmcmFtZSBjYW4gYmUgbW9kaWZpZWQsIG9yIG5ldyBjb2x1bW5zIGNyZWF0ZWQKCi0gY2FuIHVzZSB0aGUgYCRgIG9wZXJhdG9yIHRvIGFzc2lnbiBhIHZhbHVlIHRvIGEgY29sdW1uIHRoYXQgZG9lc24ndCBjdXJyZW50bHkgZXhpc3QKICAgICsgdGhlIHZlY3RvciBvbiB0aGUgcmlnaHQgb2YgdGhlIGFzc2lnbm1lbnQgYDwtYCBtdXN0IHRoYXQgYSBsZW5ndGggZXF1YWwgdG8gdGhlIG51bWJlciBvZiByb3dzIGluIHRoZSBkYXRhIGZyYW1lCi0gY2FuIGFsc28gb3ZlcndyaXRlIGV4aXN0aW5nIGNvbHVtbnMKCgpgYGB7cn0KZ2FwbWluZGVyX2V4dHJhIDwtIGdhcG1pbmRlcgpnYXBtaW5kZXJfZXh0cmEkUG9wSW5NaWxsaW9ucyA8LSBnYXBtaW5kZXJfZXh0cmEkcG9wIC8gMTAwMDAwMApnYXBtaW5kZXJfZXh0cmEkbGlmZUV4cCA8LSByb3VuZChnYXBtaW5kZXJfZXh0cmEkbGlmZUV4cCkKZ2FwbWluZGVyX2V4dHJhCmBgYAoKCiMjIE9yZGVyaW5nIGFuZCBzb3J0aW5nCgpBIHZlY3RvciBjYW4gYmUgcmV0dXJuZWQgaW4gc29ydGVkIGZvcm0gdXNpbmcgdGhlIGBzb3J0YCBmdW5jdGlvbi4KCmBgYHtyIGV2YWw9RkFMU0V9CnNvcnQoY291bnRyaWVzKQpzb3J0KGNvdW50cmllcyxkZWNyZWFzaW5nID0gVFJVRSkKYGBgCgpIb3dldmVyLCBpZiB3ZSB3YW50IHRvIHNvcnQgYW4gZW50aXJlIGRhdGEgZnJhbWUgYSBkaWZmZXJlbnQgYXBwcm9hY2ggaXMgbmVlZGVkLiBUaGUgdHJpY2sgaXMgdG8gdXNlIGBvcmRlcmAuIFJhdGhlciB0aGFuIGdpdmluZyBhIHNvcnRlZCBzZXQgb2YgKnZhbHVlcyosIGl0IHdpbGwgZ2l2ZSBzb3J0ZWQgKmluZGljZXMqLiBUaGVzZSBpbmRpY2VzIGNhbiB0aGVuIGJlIHVzZWQgZm9yIGEgc3Vic2V0IG9wZXJhdGlvbi4KCmBgYHtyfQpsZWFzdFBvcCA8LSBnYXBtaW5kZXJbb3JkZXIoZ2FwbWluZGVyJHBvcCksXQpoZWFkKGxlYXN0UG9wKQpgYGAKCgpXZSBjYW4gZXZlbiBvcmRlciBieSBtb3JlIHRoYW4gb25lIGNvbmRpdGlvbgoKYGBge3IgZXZhbD1GQUxTRX0KZ2FwbWluZGVyW29yZGVyKGdhcG1pbmRlciR5ZWFyLCBnYXBtaW5kZXIkY291bnRyeSksXQpgYGAKCmBgYHtyIGVjaG89RkFMU0V9CmhlYWQoZ2FwbWluZGVyW29yZGVyKGdhcG1pbmRlciR5ZWFyLCBnYXBtaW5kZXIkbGlmZUV4cCksXSkKYGBgCgpBIGZpbmFsIHBvaW50IG9uIGRhdGEgZnJhbWVzIGlzIHRoYXQgd2UgY2FuIGV4cG9ydCB0aGVtIG91dCBvZiBSIG9uY2Ugd2UgaGF2ZSBkb25lIG91ciBkYXRhIHByb2Nlc3NpbmcuIAoKYGBge3J9CmJ5V2VhbHRoIDwtIGdhcG1pbmRlcltvcmRlcihnYXBtaW5kZXIkZ2RwUGVyY2FwLGRlY3JlYXNpbmcgPSBUUlVFKSxdCmhlYWQoYnlXZWFsdGgpCndyaXRlLmNzdihieVdlYWx0aCwgZmlsZT0iZGF0YU9yZGVyZWRCeVdlYWx0aC5jc3YiKQpgYGAKCiMgUGxvdHRpbmcgYW5kIHN0YXRzIAoKQWxsIHlvdXIgZmF2b3VyaXRlIHR5cGVzIG9mIHBsb3QgY2FuIGJlIGNyZWF0ZWQgaW4gUgoKYGBge3IgZWNobz1GQUxTRX0KCnBhcihtZnJvdz1jKDIsMikpCmJhcnBsb3QoVkFEZWF0aHMsIGJlc2lkZSA9IFRSVUUsCiAgICAgICAgY29sID0gYygibGlnaHRibHVlIiwgIm1pc3R5cm9zZSIsICJsaWdodGN5YW4iLAogICAgICAgICAgICAgICAgImxhdmVuZGVyIiwgImNvcm5zaWxrIiksIHlsaW0gPSBjKDAsIDEwMCkpCmJveHBsb3QobGVuIH4gZG9zZSwgZGF0YSA9IFRvb3RoR3Jvd3RoLAogICAgICAgIGJveHdleCA9IDAuMjUsIGF0ID0gMTozIC0gMC4yLAogICAgICAgIHN1YnNldCA9IHN1cHAgPT0gIlZDIiwgY29sID0gInllbGxvdyIsCiAgICAgICAgbWFpbiA9ICJHdWluZWEgUGlncycgVG9vdGggR3Jvd3RoIiwKICAgICAgICB4bGFiID0gIlZpdGFtaW4gQyBkb3NlIG1nIiwKICAgICAgICB5bGFiID0gInRvb3RoIGxlbmd0aCIsCiAgICAgICAgeGxpbSA9IGMoMC41LCAzLjUpLCB5bGltID0gYygwLCAzNSksIHlheHMgPSAiaSIpCmJveHBsb3QobGVuIH4gZG9zZSwgZGF0YSA9IFRvb3RoR3Jvd3RoLCBhZGQgPSBUUlVFLGJveHdleCA9IDAuMjUsIGF0ID0gMTozICsgMC4yLHN1YnNldCA9IHN1cHAgPT0gIk9KIiwgY29sID0gIm9yYW5nZSIpCmxlZ2VuZCgyLCA5LCBjKCJBc2NvcmJpYyBhY2lkIiwgIk9yYW5nZSBqdWljZSIpLGZpbGwgPSBjKCJ5ZWxsb3ciLCAib3JhbmdlIikpCnNldC5zZWVkKDE0KQp4IDwtIHJjaGlzcSgxMDAsIGRmID0gNCkKIyMgaWYgeW91IHJlYWxseSBpbnNpc3Qgb24gdXNpbmcgaGlzdCgpIC4uLiA6Cmhpc3QoeCwgZnJlcSA9IEZBTFNFLCB5bGltID0gYygwLCAwLjIpKQpjdXJ2ZShkY2hpc3EoeCwgZGYgPSA0KSwgY29sID0gMiwgbHR5ID0gMiwgbHdkID0gMiwgYWRkID0gVFJVRSkKcGllKGMoU2t5ID0gNzgsICJTdW5ueSBzaWRlIG9mIHB5cmFtaWQiID0gMTcsICJTaGFkeSBzaWRlIG9mIHB5cmFtaWQiID0gNSksCiAgICBpbml0LmFuZ2xlID0gMzE1LCBjb2wgPSBjKCJkZWVwc2t5Ymx1ZSIsICJ5ZWxsb3ciLCAieWVsbG93MyIpLCBib3JkZXIgPSBGQUxTRSkKYGBgCgoKLSBTaW1wbGUgcGxvdHMgYXJlIHN1cHBvcnRlZCBpbiB0aGUgKmJhc2UqIGRpc3RyaWJ1dGlvbiBvZiBSICh3aGF0IHlvdSBnZXQgYXV0b21hdGljYWxseSB3aGVuIHlvdSBkb3dubG9hZCBSKS4gCiAgICArIGBib3hwbG90YCwgYGhpc3RgLCBgYmFycGxvdGAsLi4uIGFsbCBvZiB3aGljaCBhcmUgZXh0ZW5zaW9ucyBvZiB0aGUgYmFzaWMgYHBsb3RgIGZ1bmN0aW9uCi0gTWFueSBkaWZmZXJlbnQgY3VzdG9taXNhdGlvbnMgYXJlIHBvc3NpYmxlCiAgICArIGNvbG91ciwgb3ZlcmxheSBwb2ludHMgLyB0ZXh0LCBsZWdlbmRzLCBtdWx0aS1wYW5lbCBmaWd1cmVzCi0gKioqWW91IG5lZWQgdG8gdGhpbmsgYWJvdXQgaG93IGJlc3QgdG8gdmlzdWFsaXNlIHlvdXIgZGF0YSoqKiAKICAgICsgaHR0cDovL3d3dy5iaW9pbmZvcm1hdGljcy5iYWJyYWhhbS5hYy51ay90cmFpbmluZy5odG1sI2ZpZ3VyZWRlc2lnbgotIFJlZmVyZW5jZXMuLgogICAgKyBbUXVpY2stUl0oaHR0cDovL3d3dy5zdGF0bWV0aG9kcy5uZXQvZ3JhcGhzL2luZGV4Lmh0bWwpCiAgICArIFtSIGdyYXBoIGdhbGxlcnldKGh0dHBzOi8vd3d3LnItZ3JhcGgtZ2FsbGVyeS5jb20vKQogICAgClBsb3RzIGNhbiBiZSBjb25zdHJ1Y3RlZCBmcm9tIHZlY3RvcnMgb2YgbnVtZXJpYyBkYXRhLCBzdWNoIGFzIHRoZSBkYXRhIHdlIGdldCBmcm9tIGEgcGFydGljdWxhciBjb2x1bW4gaW4gYSBkYXRhIGZyYW1lCgpgYGB7cn0KaGlzdChnYXBtaW5kZXIkbGlmZUV4cCkKYGBgCgpTY2F0dGVyIHBsb3RzIG9mIHR3byB2YXJpYWJsZXMgcmVxdWlyZSB0d28gYXJndW1lbnRzOyBvbmUgZm9yIHRoZSBgeGAgYW5kIG9uZSBmb3IgdGhlIGB5YCBheGlzLgoKYGBge3J9CnBsb3QoZ2FwbWluZGVyJHBvcCxnYXBtaW5kZXIkbGlmZUV4cCkKYGBgCgoKQmFycGxvdHMgYXJlIGNvbW1vbmx5LXVzZWQgZm9yIGNvdW50cyBvZiBjYXRlZ29yaWNhbCBkYXRhCgpgYGB7cn0KYmFycGxvdCh0YWJsZShnYXBtaW5kZXIkY29udGluZW50KSkKYGBgCgpCb3hwbG90cyBhcmUgZ29vZCBmb3IgdmlzdWFsaXNpbmcgYW5kIGNvbXBhcmluZyBkaXN0cmlidXRpb25zLiBIZXJlIHRoZSBgfmAgc3ltYm9sIHNldHMgdXAgYSBmb3JtdWxhLCB0aGUgZWZmZWN0IG9mIHdoaWNoIGlzIHRvIHB1dCB0aGUgY2F0ZWdvcmljYWwgdmFyaWFibGUgb24gdGhlIGB4YCBheGlzIGFuZCBjb250aW51b3VzIHZhcmlhYmxlIG9uIHRoZSBgeWAgYXhpcy4KCmBgYHtyfQpib3hwbG90KGdhcG1pbmRlciRnZHBQZXJjYXAgfiBnYXBtaW5kZXIkY29udGluZW50KQpgYGAgCgoqTG90cyogb2YgY3VzdG9taXNhdGlvbnMgYXJlIHBvc3NpYmxlIHRvIGVuaGFuY2UgdGhlIGFwcGFlcmFuY2Ugb2Ygb3VyIHBsb3RzLiBOb3QgZm9yIHRoZSBmYWludC1oZWFydGVkLCB0aGUgaGVscCBwYWdlcyBgP3Bsb3RgIGFuZCBgP3BhcmAgZ2l2ZSB0aGUgZnVsbCBkZXRhaWxzLiBJbiBzaG9ydCwKCi0gQXhpcyBsYWJlbHMsIGFuZCB0aXRsZXMgY2FuIGJlIHNwZWNpZmllZCBhcyBjaGFyYWN0ZXIgc3RyaW5ncy4gCgotIFIgcmVjb2duaXNlcyBtYW55IHByZXNldCBuYW1lcyBhcyBjb2xvdXJzLiBUbyBnZXQgYSBmdWxsIGxpc3QgdXNlIGBjb2xvdXJzKClgCiAgICArIGNoZWNrIHRoaXMgW29ubGluZSByZWZlcmVuY2VdKGh0dHA6Ly93d3cuc3RhdC5jb2x1bWJpYS5lZHUvfnR6aGVuZy9maWxlcy9SY29sb3IucGRmKSB0byBzZWUgd2hhdCB0aGV5IGNvcnJlc3BvbmQgdG8KLSBQbG90dGluZyBjaGFyYWN0ZXJzIGNhbiBiZSBzcGVjaWZpZWQgdXNpbmcgYSBwcmUtZGVmaW5lZCBudW1iZXI6LQoKYGBge3IgZWNobz1GQUxTRX0KcGFyKG1hcj1jKDAuMSwwLjEsMC4xLDAuMSkpCmkgPC0gMDoyNAoKeCA8LSBmbG9vcihpIC81KSArIDEKeSA8LSBpICUlNQoKcGxvdCgxOjEwLCB0eXBlPSJuIiwgeGxpbSA9IGMoMSw1KSwgeWxpbT1jKC0xLDUpLGF4ZXM9Rix4bGFiPSIiLHlsYWI9IiIpCnBvaW50cyh4LHkscGNoPWkrMSwgY2V4PTIpCnRleHQoeCx5LTAuMyxpKzEpCmBgYAoKUHV0dGluZyBpdCBhbGwgdG9nZXRoZXIuCgpgYGB7cn0KcGxvdChnYXBtaW5kZXIkcG9wLGdhcG1pbmRlciRsaWZlRXhwLHBjaD0xNiwKICAgICBjb2w9InJlZCIseWxhYj0iTGlmZSBFeHBlY3RhbmN5IiwKICAgICB4bGFiPSJQb3B1bGF0aW9uIixtYWluPSJMaWZlIEV4cGVjdGFuY3kgdHJlbmQgd2l0aCBwb3B1bGF0aW9uIikKYGBgCgoKVGhlIHNhbWUgY3VzdG9taXNhdGlvbnMgY2FuIGJlIHVzZWQgZm9yIHZhcmlvdXMgcGxvdHM6LQoKYGBge3J9CmJveHBsb3QoZ2FwbWluZGVyJGdkcFBlcmNhcCB+IGdhcG1pbmRlciRjb250aW5lbnQsCiAgICAgICAgY29sPWMoInJlZCIsIm9yYW5nZSIsImdyZWVuIiwiYmx1ZSIsInB1cnBsZSIpLAogICAgICAgIG1haW49IkdEUCBwZXItY29udGluZW50IiwKICAgICAgICB4bGFiPSJDb250aW5lbnQiLAogICAgICAgIHlsYWI9IkdEUCIpCmBgYAoKYW4gYWxzbyBzYXZlIHBsb3RzIHRvIGEgZmlsZSBjYWxsaW5nIHRoZSBgcGRmYCBvciBgcG5nYCBmdW5jdGlvbnMgYmVmb3JlIGV4ZWN1dGluZyB0aGUgY29kZSB0byBjcmVhdGUgdGhlIHBsb3QuIAogCiAKYGBge3J9CnBkZigibXlMaXR0bGVQbG90LnBkZiIpCmJhcnBsb3QodGFibGUoZ2FwbWluZGVyJGNvbnRpbmVudCkpCmRldi5vZmYoKQpgYGAKCkFueSBwbG90cyBjcmVhdGVkIGluLWJldHdlZW4gdGhlIGBwZGYoLi4pYCBhbmQgYGRldi5vZmYoKWAgbGluZXMgd2lsbCBnZXQgc2F2ZWQgdG8gdGhlIG5hbWVkIGZpbGUuIFRoZSBgZGV2Lm9mZigpYCBsaW5lIGlzIHZlcnkgaW1wb3J0YW50OyB3aXRob3V0IGl0IHlvdSB3aWxsIG5vdCBiZSBhYmxlIHRvIHZpZXcgdGhlIHBsb3QgeW91IGhhdmUgY3JlYXRlZC4gYHBkZmAgZmlsZXMgYXJlIHVzZWZ1bCBiZWNhdXNlIHlvdSBjYW4gY3JlYXRlIGRvY3VtZW50cyB3aXRoIG11bHRpcGxlIHBhZ2VzLiBNb3Jlb3ZlciwgdGhleSBjYW4gYmUgaW1wb3J0ZWQgaW50byB0b29scyBzdWNoIGFzIEFkb2JlIElsbHVzdHJhdG9yIHRvIGJlIGluY29ycG9yYXRlZCB3aXRoIG90aGVyIGdyYXBoaWNzLiAKCiMjIFRoZSBjYW52YXMgbW9kZWwKCkl0IGlzIGltcG9ydGFudCB0byByZWFsaXNlIHRoYXQgYmFzZSBncmFwaGljcyBpbiBSIHVzZXMgYSAqImNhbnZhcyBtb2RlbCIqIHRvIGNyZWF0ZSBncmFwaGljcy4gV2UgY2FuIG9ubHkgb3ZlcmxheSBleHRyYSBpbmZvcm1hdGlvbiBvbi10b3Agb2YgYW4gZXhpc2luZyBwbG90IGFuZCBjYW5ub3QgInVuZG8iIHdoYXQgaXMgYWxyZWFkeSBkcmF3bi4KCkxldCdzIHN1cHBvc2Ugd2Ugd2FudCB0byB2aXN1YWxpc2UgYW5kIGxpZmUgZXhwZWN0YW5jeSBhbmQgcG9wdWxhdGlvbiBvZiBjb3VudHJpZXMgaW4gRXVyb3BlIGFuZCBBZnJpY2EuIEZpcnN0LCBjcmVhdGUgdHdvIGRhdGFzZXRzIHRvIHJlcHJlc2VudCBFdXJvcGVhbiBhbmQgQWZyaWNhbiBjb3VudHJpZXMgaW4gdGhlIHllYXIgMjAwMgoKYGBge3J9CmV1cm9EYXRhIDwtIGdhcG1pbmRlcltnYXBtaW5kZXIkY29udGluZW50ID09ICJFdXJvcGUiICYgZ2FwbWluZGVyJHllYXIgPT0gMjAwMixdCmRpbShldXJvRGF0YSkKYGBgCgpgYGB7cn0KYWZyRGF0YSA8LSBnYXBtaW5kZXJbZ2FwbWluZGVyJGNvbnRpbmVudCA9PSAiQWZyaWNhIiAmIGdhcG1pbmRlciR5ZWFyID09IDIwMDIsXQpkaW0oYWZyRGF0YSkKYGBgCgpXZSBjYW4gc3RhcnQgYnkgcGxvdHRpbmcgdGhlIGxpZmUgZXhwZWN0YW5jeSBvZiB0aGUgRXVyb3BlYW4gY291bnRyaWVzIGFzIHJlZCBkb3RzLgoKYGBge3J9CnBsb3QoZXVyb0RhdGEkcG9wLCBldXJvRGF0YSRsaWZlRXhwLGNvbD0icmVkIiwKICAgICBwY2g9MTYsCiAgICAgeGxhYj0iUG9wdWxhdGlvbiIsCiAgICAgeWxhYj0iTGlmZSBFeHBlY3RhbmN5IikKYGBgCgpUaGUgYHBvaW50c2AgZnVuY3Rpb24gY2FuIGJlIHVzZWQgcHV0IGV4dHJhIHBvaW50cyBjb3JyZXNwb25kaW5nIHRvIEFmcmljYW4gY291bnRyaWVzIG9uIHRoZSBleGlzdGluZyBwbG90LiAKCmBgYHtyIGV2YWw9RkFMU0V9CnBvaW50cyhhZnJEYXRhJHBvcCwgYWZyRGF0YSRsaWZlRXhwLGNvbD0iYmx1ZSIscGNoPTE2KQpgYGAKCmBgYHtyIGVjaG89RkFMU0V9CnBsb3QoZXVyb0RhdGEkcG9wLCBldXJvRGF0YSRsaWZlRXhwLGNvbD0icmVkIiwKICAgICBwY2g9MTYsCiAgICAgeGxhYj0iUG9wdWxhdGlvbiIsCiAgICAgeWxhYj0iTGlmZSBFeHBlY3RhbmN5IikKcG9pbnRzKGFmckRhdGEkcG9wLCBhZnJEYXRhJGxpZmVFeHAsY29sPSJibHVlIixwY2g9MTYpCmBgYAoKV2FpdCwgaG93IG1hbnkgQWZyaWNhbiBjb3VudHJpZXMgZGlkIHdlIGhhdmU/CgpgYGB7cn0KbnJvdyhhZnJEYXRhKQpgYGAKClRoZSBwcm9ibGVtIGhlcmUgaXMgdGhhdCB0aGUgaW5pdGlhbCBsaW1pdHMgb2YgdGhlIHkgYXhpcyB3ZXJlIGRlZmluZWQgdXNpbmcgdGhlIGxpZmUgZXhwZWN0YW5jeSByYW5nZSBvZiB0aGUgRXVyb3BlYW4gZGF0YS4gV2UgY2FuIG9ubHkgYWRkIHBvaW50cyB0byB0aGUgZXhpc3RpbmcgcGxvdHRpbmcgd2luZG93LCBzbyBhbnkgQWZyaWNhbiBjb3VudHJpZXMgd2l0aCBsaWZlIGV4cGVjdGFuY3kgb3V0c2lkZSB0aGlzIHJhbmdlIHdpbGwgbm90IGdldCBkaXNwbGF5ZWQuCgpXZSBjYW4gZGVmaW5lIHRoZSBheGVzIHdoZW4gd2UgY3JlYXRlIHRoZSBwbG90IHVzaW5nIGB4bGltYCBhbmQgYHlsaW1gLgoKYGBge3J9CnBsb3QoZXVyb0RhdGEkcG9wLCBldXJvRGF0YSRsaWZlRXhwLGNvbD0icmVkIiwKICAgICBwY2g9MTYsCiAgICAgeGxhYj0iUG9wdWxhdGlvbiIsCiAgICAgeWxhYj0iTGlmZSBFeHBlY3RhbmN5IiwKICAgICB4bGltPWMoMCw4ZTcpLHlsaW09YygzMCw5MCkpCnBvaW50cyhhZnJEYXRhJHBvcCwgYWZyRGF0YSRsaWZlRXhwLGNvbD0iYmx1ZSIscGNoPTE2KQpgYGAKCgoKCk90aGVyIHVzZWZ1bCBmdW5jdGlvbnMgZm9yIGFkZGluZyBmZWF0dXJlcyB0byBhbiBleGlzdGluZyBwbG90IGluY2x1ZGUgYHRleHRgLCBgYWJsaW5lYCwgYGdyaWRgLCBgbGVnZW5kYCBhbW9uZyBvdGhlcnMKCkFub3RoZXIgdXNlZnVsIHRyaWNrIGZvciBwbG90dGluZyBpcyB0byB0YWtlIGFkdmFudGFnZSBvZiBwcmUtZXhpc3RpbmcgY29sb3VyIHBhbGV0dGVzIGluIFIuIFRoZSBgUkNvbG9yQnJld2VyYCBwYWNrYWdlIGlzIGEgdXNlZnVsIHBhY2thZ2UgZm9yIHN1Y2ggcGFsZXR0ZXM7IG1hbnkgb2Ygd2hpY2ggYXJlIGZyaWVuZGx5IHRvIHRob3NlIHdpdGggdmlzdWFsIGltcGFpcm1lbnRzLgoKYGBge3J9CmxpYnJhcnkoUkNvbG9yQnJld2VyKQpkaXNwbGF5LmJyZXdlci5hbGwoY29sb3JibGluZEZyaWVuZGx5ID0gVFJVRSkKCmBgYAoKVGhlIGBicmV3ZXIucGFsYCBmdW5jdGlvbiBjYW4gcmV0dXJuIHRoZSBuYW1lcyBvZiBgbmAgY29sb3VycyBmcm9tIG9uZSBvZiB0aGUgcHJlLWRlZmluZWQgcGFsZXR0ZXMgdG8gYmUgdXNlZCBhcyBhIGBjb2xgIGFyZ3VtZW50IHRvIGEgcGxvdHRpbmcgZnVuY3Rpb24uCgpgYGB7cn0KYm94cGxvdChnYXBtaW5kZXIkZ2RwUGVyY2FwIH4gZ2FwbWluZGVyJGNvbnRpbmVudCxjb2w9YnJld2VyLnBhbCg1LCJTZXQyIiksCiAgICAgICAgbWFpbj0iR0RQIHBlci1jb250aW5lbnQiLAogICAgICAgIHhsYWI9IkNvbnRpbmVudCIsCiAgICAgICAgeWxhYj0iR0RQIikKYGBgCgoqKioqKioKKioqKioqCioqKioqKgoKIyMjIEV4ZXJjaXNlCgotIFRoZSBwbG90IG9mIHBvcHVsYXRpb24gdmVyc3VzIEdEUCBzaG93cyBhbmQgb2J2aW91cyBzZXQgb2Ygb3V0bGllcnMKICArIHdoaWNoIGNvdW50cmllcyBkbyB0aGUgcG9pbnRzIHJlcHJlc2VudD8KICArIGNhbiB5b3UgcGxvdCB0aGVzZSBwb2ludHMgaW4gYSBkaWZmZXJlbnQgY29sb3VyPwogICsgdXNlIHRoZSBgYWJsaW5lYCBmdW5jdGlvbiB0byBkcmF3IGEgdmVydGljYWwgbGluZSB0byBzZXBhcmF0ZSB0aGUgb3V0bGllcnMgZnJvbSB0aGUgcmVzdCBvZiB0aGUgcGxvdAogICAgKyBzZWUgYmVsb3cgZm9yIHdoYXQgdGhlIGdyYXBoIGlzIGludGVuZGVkIHRvIGxvb2sgbGlrZQohW10oaW1hZ2VzL3Bsb3R0aW5nX2V4ZXJjaXNlX3RhcmdldC5wbmcpCiAgCmBgYHtyfQoKCmBgYAogIAoKKioqKioqCioqKioqKgoqKioqKioKClRoZSBgY29sYCBhcmd1bWVudCB0byBgcGxvdGAgZG9lc24ndCBoYXZlIHRvIGNvbnRhaW4gb25seSBvbmUgY29sb3VyLiBXZSBjYW4gdXNlIGEgdmVjdG9yIHRoYXQgYXNzaWducyBhIGNvbG91ciB0byBlYWNoIHBvaW50IHRvIGJlIHBsb3R0ZWQuIEluIHRoZSBmb2xsb3dpbmcgY29kZSB3ZTotCgotIGNyZWF0ZSBhIHN1YnNldCBvZiB0aGUgZGF0YSBkZXNjcmliaW5nIEV1cm9wZWFuIGFuZCBBZnJpY2FuIGNvdW50cmllcyBpbiAyMDAyCi0gY3JlYXRlIGEgKmR1bW15KiB2ZWN0b3IgdGhhdCBpcyBqdXN0IGByZWRgIHJlcGVhdGVkIGFzIG1hbnkgdGltZXMgYXMgcm93cyBpbiB0aGUgZGF0YSBmcmFtZQoKYGBge3J9CnN1YnNldF9hZnJfZXVyIDwtIGdhcG1pbmRlcltnYXBtaW5kZXIkY29udGluZW50ICVpbiUgYygiRXVyb3BlIiwgIkFmcmljYSIpICYgZ2FwbWluZGVyJHllYXIgPT0gMjAwMixdCm15Y29sIDwtIHJlcCgicmVkIixucm93KHN1YnNldF9hZnJfZXVyKSkKCnBsb3Qoc3Vic2V0X2Fmcl9ldXIkcG9wLCBzdWJzZXRfYWZyX2V1ciRsaWZlRXhwLAogICAgIGNvbD1teWNvbCwKICAgICBwY2g9MTYpCgpgYGAKIApXZSBjYW4gcmVwbGFjZSB0aGUgaXRlbXMgaW4gdGhlIGNvbG91ciB2ZWN0b3IgdGhhdCBjb3JyZXNwb25kIHRvIGFuIEFmcmljYW4gY291bnRyeSB3aXRoIGEgZGlmZmVyZW50IHZhbHVlCgotIHdlIGNhbiBub3cgY3JlYXRlIHRoZSBzYW1lIHBsb3QgYXMgYmVmb3JlLCBidXQgb25seSB1c2luZyB0aGUgYHBsb3RgIGZ1bmN0aW9uIG9uY2UKIApgYGB7cn0KbXljb2xbd2hpY2goc3Vic2V0X2Fmcl9ldXIkY29udGluZW50ID09ICJBZnJpY2EiKV0gPC0gImJsdWUiCnBsb3Qoc3Vic2V0X2Fmcl9ldXIkcG9wLCBzdWJzZXRfYWZyX2V1ciRsaWZlRXhwLAogICAgIGNvbD1teWNvbCwKICAgICBwY2g9MTYsCiAgICAgeGxhYj0iUG9wdWxhdGlvbiIsCiAgICAgeWxhYj0iTGlmZSBFeHBlbmN0YW5jeSIpCmBgYAoKCklmIHdlIHByZWZlcnJlZCwgd2UgY291bGQgcGxvdCB0aGUgZGF0YSBmb3IgRXVyb3BlYW4gYW5kIEFmcmljYW4gY291bnRyaWVzIGluIHNlcGFyYXRlIHBsb3RzIHNpZGUtYnktc2lkZS4KCi0gaGVyZSB3ZSBzcGVjaWZ5IGEgKmxheW91dCogb2YgdGhlIHBsb3QgdXNpbmcgdGhlIGBtZnJvd2AgcGxvdHRpbmcgcGFyYW1ldGVyCi0gYGMoMSwyKWAgY29ycmVzcG9uZHMgdG8gMSAqcm93KiBhbmQgMiAqY29sdW1ucyoKLSAqKm1ha2Ugc3VyZSB5b3UgcnVuIHRoZSBlbnRpcmUgY29kZSBjaHVuayBhdCBvbmNlIGJ5IHByZXNzaW5nIHRoZSBncmVlbiBydW4gYnV0dG9uLCBvciBoaWdobGlnaHRpbmcgYWxsIHRoZSBsaW5lcyoqCiAgKyBydW5uaW5nIHRoZSBjb2RlIGxpbmUtYnktbGluZSB3b24ndCBoYXZlIHRoZSBjb3JyZWN0IGVmZmVjdAoKYGBge3J9CnBhcihtZnJvdz1jKDEsMikpCgpwbG90KGV1cm9EYXRhJHBvcCwgZXVyb0RhdGEkbGlmZUV4cCxjb2w9InJlZCIsCiAgICAgcGNoPTE2LAogICAgIHhsYWI9IlBvcHVsYXRpb24iLAogICAgIHlsYWI9IkxpZmUgRXhwZWN0YW5jeSIsCiAgICAgbWFpbj0iRXVyb3BlYW4gQ291bnRyaWVzIiwKICAgIHhsaW09YygwLDhlNykseWxpbT1jKDMwLDkwKSkKCnBsb3QoYWZyRGF0YSRwb3AsIGFmckRhdGEkbGlmZUV4cCxjb2w9ImJsdWUiLAogICAgIHBjaD0xNiwKICAgICB4bGFiPSJQb3B1bGF0aW9uIiwKICAgICB5bGFiPSJMaWZlIEV4cGVjdGFuY3kiLAogICAgIG1haW49IkFmcmljYW4gQ291bnRyaWVzIiwKICAgIHhsaW09YygwLDhlNykseWxpbT1jKDMwLDkwKSkKCgpgYGAKCgoKV2UgY2FuJ3QgcmVhbGx5IGhhdmUgYSBydW4tdGhyb3VnaCBvZiB0aGUgUiBsYW5ndWFnZSB3aXRob3V0IGF0IGxlYXN0ICptZW50aW9uaW5nKiBzdGF0aXN0aWNzISBIb3dldmVyLCBsaWtlIHBsb3R0aW5nIGl0IGlzIGEgdmFzdCBmaWVsZC4gVGhlIG1haW4gY2hhbGxlbmdlcyBhcmUgcHV0dGluZyB5b3VyIGRhdGEgaW4gdGhlIGNvcnJlY3QgZm9ybWF0ICh3aGljaCB3ZSBoYXZlIGNvdmVyZWQgaGVyZSksIGFuZCBkZWNpZGluZyB3aGljaCB0ZXN0IHRvIHVzZSAoKip3aGljaCBSIHdpbGwgbm90IGFkdmlzZSB5b3Ugb24hKiopIAoKLSBJZiB5b3UgaGF2ZSBzb21lIGJhY2tncm91bmQgaW4gc3RhdGlzdGljcyB5b3UgY2FuIHNlZSB0aGlzIGNvdXJzZSBmcm9tIHRoZSBbQmFicmFoYW0gSW5zdGl0dXRlIEJpb2luZm9ybWF0aWNzIENvcmVdKGh0dHA6Ly93d3cuYmlvaW5mb3JtYXRpY3MuYmFicmFoYW0uYWMudWsvdHJhaW5pbmcvUl9TdGF0aXN0aWNzL0ludHJvZHVjdGlvbiUyMHRvJTIwU3RhdGlzdGljcyUyMHdpdGglMjBSLnBkZikgYWJvdXQgaG93IHRvIHBlcmZvcm0gc3RhdGlzdGljYWwgdGVzdGluZyBpbiBSLgotIElmIHlvdSBuZWVkIGEgbW9yZSBiYXNpYyBncm91bmRpbmcgaW4gd2hpY2ggc3RhdGlzdGljYWwgdGVzdCB0byB1c2UsIHlvdSBjYW4gc2VlIHRoaXMgY291cnNlIGZyb20gW0NSVUsgQ2FtYnJpZGdlIEluc3RpdHV0ZV0oaHR0cDovL2Jpb2luZm9ybWF0aWNzLWNvcmUtc2hhcmVkLXRyYWluaW5nLmdpdGh1Yi5pby9JbnRyb2R1Y3Rpb25Ub1N0YXRzLykKICAKVGhlIGB0LnRlc3RgIGZ1bmN0aW9uIGlzIHByb2JhYmx5IHRoZSBtb3N0IGZ1bmRhbWVudGFsIHN0YXRpc3RpY2FsIHRlc3RpbmcgZnVuY3Rpb24gaW4gUiwgYW5kIGNhbiBiZSBhZGFwdGVkIHRvIG1hbnkgZGlmZmVyZW50IHNpdHVhdGlvbnMuIEZ1bGwgZGV0YWlscyBhcmUgZ2l2ZW4gaW4gdGhlIGhlbHAgcGFnZSBgP3QudGVzdGAuCgoKVGhlIGxpZmUgZXhwZWN0YW5jeSBsb29rcyB0byBiZSBkaWZmZXJlbnQgYmV0d2VlbiBFdXJvcGUgYW5kIEFmcmljYQoKYGBge3J9CmJveHBsb3QoZ2FwbWluZGVyJGxpZmVFeHAgfiBnYXBtaW5kZXIkY29udGluZW50KQpgYGAKClRoZSBvdXRwdXQgZnJvbSBgdC50ZXN0YCBjYW4gYmUgdXNlZCB0byBqdWRnZSBpZiB0aGVyZSBpcyBhIHN0YXRpc3RpY2FsbHktc2lnbmlmaWNhbnQgZGlmZmVyZW5jZSBpbiBtZWFucwoKLSBuZWVkIHRvIHNwZWNpZnkgdHdvICp2ZWN0b3JzKiwgd2hpY2ggYXJlIHRoZSB2YWx1ZXMgd2Ugd2FudCB0byB0ZXN0IGZvciBkaWZmZXJlbmNlIGluIG1lYW5zCiAgICArIHRoZXkgZG9uJ3QgbmVlZCB0byBjb250YWluIHRoZSBzYW1lIG51bWJlciBvZiB2YWx1ZXMKCmBgYHtyfQp0LnRlc3QoZXVyb0RhdGEkbGlmZUV4cCxhZnJEYXRhJGxpZmVFeHApCmBgYAoKCgpXZXJlIG91ciBkYXRhIG5vdCBub3JtYWxseS1kaXN0cmlidXRlZCB3ZSBjb3VsZCB1c2UgYHdpbGNveC50ZXN0YCwgZm9yIGV4YW1wbGUuICBGb3J0dW5hdGVseSwgbW9zdCBzdGF0aXN0aWNhbCB0ZXN0cyBjYW4gYmUgYWNjZXNzZWQgaW4gYSBzaW1pbGFyIG1hbm5lciwgc28gaXQgaXMgZWFzeSB0byBzd2l0Y2ggYmV0d2VlbiB1c2luZyBkaWZmZXJlbnQgdGVzdHMgcHJvdmlkZWQgeW91ciBkYXRhIGFyZSBpbiB0aGUgY29ycmVjdCBmb3JtYXQuIFRvIHJlLWl0ZXJhdGUsIHRoZSBza2lsbCBpcyBpbiBjaG9vc2luZyB3aGljaCB0ZXN0IGlzIGFwcHJvcHJpYXRlLgoKUiBhbHNvIGhhcyBmdW5jdGlvbmFsaXR5IGZvciBhc3Nlc3NpbmcgY29ycmVsYXRpb24gYmV0d2VlbiBzZXRzIG9mIHZhbHVlcy4gRm9yIGV4YW1wbGUsIHRoZXJlIHNlZW1zIHRvIGJlIGEgcmVsYXRpb25zaGlwIGJldHdlZW4gYSBjb3VudHJ5J3Mgd2VhbHRoIGFuZCBsaWZlIGV4cGVuY3RhbmN5Oi0KCmBgYHtyfQpwbG90KGV1cm9EYXRhJGdkcFBlcmNhcCxldXJvRGF0YSRsaWZlRXhwKQpgYGAKClRoaXMgY2FuIGJlIHF1YW50aWZpZWQgYnkgY2FsY3VsYXRpbmcgdGhlICpjb3JyZWxhdGlvbiouIENvbW1vbmx5IHRoZSAkUl4yJCB2YWx1ZSBpcyByZXBvcnRlZAoKYGBge3J9CmNvcihldXJvRGF0YSRnZHBQZXJjYXAsZXVyb0RhdGEkbGlmZUV4cCkKY29yKGV1cm9EYXRhJGdkcFBlcmNhcCxldXJvRGF0YSRsaWZlRXhwKV4yCmBgYAoKQSAqbGluZWFyIG1vZGVsKiBjYW4gYmUgdXNlZCB0byBhc3Nlc3MgdGhlIHJlbGF0aW9uc2hpcCwgd2hpY2ggd2UgY2FuIG92ZXJsYXkgb24gdGhlIHBsb3QgdXNpbmcgdGhlIGZ1bmN0aW9uIGBhYmxpbmVgLiBUaGUgKmNvZWZmaWNpZW50cyogb2YgdGhlIG1vZGVsIGdpdmUgdGhlICpzbG9wZSogYW5kICppbnRlcmNlcHQqIG9mIHRoZSBzdHJhaWdodCBsaW5lCgpgYGB7cn0KbW9kZWwgPC0gbG0oZXVyb0RhdGEkbGlmZUV4cH5ldXJvRGF0YSRnZHBQZXJjYXApCnBsb3QoZXVyb0RhdGEkZ2RwUGVyY2FwLGV1cm9EYXRhJGxpZmVFeHApCmFibGluZShtb2RlbCkKbW9kZWwkY29lZmZpY2llbnRzCgpgYGAKCgo=