1 Statistical Inference: A Quick Overview

At the core of statistical inference is about to use an estimator \(\hat{\theta}(X)\) to guess the unknown value of \(\theta\) a population parameter of interest based on a random sample dataset \(X\) drawn from that population. The most common case of \(\theta\) will be the population mean \(\mu = E(x)\) where \(x\) denotes the population following an unknown distribution \(x \overset{d}\sim F\). Other popular parameters can be a median, a variance, a confidence interval of the mean, or a regression model coefficient, a confidence interval of the regression coefficient, …, etc.

1.1 Sampling Distribution

How do we know our guess (our estimator) is a good one? That is, how do we measure the error of our estimator in statistical inference, without knowing the ground truth of the population? The distribution function of population \(F\) is unknown. As a result, to make our statistical inference from a sample dataset we rely on the Central Limit Theorem. In its vanilla version CLT only requires the population to have finite second moment and our sample dataset is identically and independently distributed (i.i.d.). It allows us to derive the limiting distribution (as \(n \rightarrow \infty\)) of the sampling distribution of a sample mean, which in turn can be used to measure the error of our guess \(\hat{\theta} = \frac{1}{n}\sum_ix_i\) to the unknown population parameter \(\theta = \mu\).

To be concrete, the vanilla CLT indicates that the sampling distribution of sample mean \(\bar{X} = \frac{1}{n}\sum_ix_i\) has the following limiting distribution:

\[ \bar{X}_n \overset{d}\rightarrow \text{Normal}(\mu, \frac{\sigma}{\sqrt{n}}), \]

where \(\mu\) is the population mean and \(\sigma\) the population standard deviation. This is elegant since Normal distribution is mathematically very friendly to deal with.

Ideally we’d like to create multiple (as many as possible) random sample datasets to measure our guess against the population. In reality due to resource constraint we usually end up with one and only such sample dataset. But based on CLT we have a solid theoretical ground to measure our guess (with its asymptotic sampling distribution) even from only one sample of size \(n\), provided that \(n\) is large enough.

Different versions of CLT can be formulated based on the estimator we are using, in order to derive the aysmptotic sampling distribution of that estimator. So we also have CLT applicable to, say, a regression model coefficient. Let’s exactly how we test the null effect of a regressor on the regressand. In general, any estimator in a form of weighted averaging can be adapted to CLT.

The usual workflow of statistical inference will be to use CLT to derive the analytical solution of the asymptotic sampling distribution of the estimator. But this is not always achievable. The more complicated the estimator the harder it can be analyzed in a trackable way. And some estimators can be harder to deal with even if they are simple in their own. One such well-known example is the sample median (to guess the population median of course), which requires order statistics come to play. Indeed there is no closed form solution for the variance of sample median unless we assume the population distribution to be a certain kind.1

This is where bootstrap sampling comes to shine. The idea of boostrap sampling is to use the sample and the only sample as a surrogate population, to approximate the underlying sampling distribution of our estimator which otherwise is untrackable.

1.2 Bootstrap Distribution

Efron (1992) propose the bootstrapping technique as a solution to estimate the variance (or the confidence interval) of a given estimator, such that we can draw conclusion about the quaility of our inference, especially when there is no analytical solution to derive the variance of that estimator.

Bootstrapping can be simply defined as drawing i.i.d. sample of the same size \(n\) from a given sample. In some literatures this is also called the resample. To strictly follow i.i.d. the sampling must be done with replacement.

With enough computing power, we can generate as many resamples \(X_b\) as we want and for each resample we calculate the value of our estimator \(\hat{\theta}_b = \hat{\theta}(X_b)\) (termed as the estimate). The resulting distribution of bootstrapped estimates from a given sample \(X\) is referred to as the bootstrap distribution.

It has been proven that the limiting distribution of a bootstrap distribution is actually the same as that of the sampling distribution, for a variety of estimators widely used for inference. (SINGH 1981)

To be clear let’s put it in notation:

\[ \underbrace{(\hat{\theta}_b - \hat{\theta})}_\text{Bootstrap Distribution} \overset{d}\rightarrow \underbrace{(\hat{\theta} - \theta) \vphantom{\hat{\theta}_b}}_\text{Sampling Distribution}, \]

where \(\hat{\theta}\) is the estimate derived from our only sample to infer the parameter \(\theta\), and \(\hat{\theta}_b\) is the estimate derived from the bootstrap sample out of the original sample.2

Due to practical reason we only have one sample to derive \(\hat{\theta}\), but we can do as many as bootstrap samples from that sample to derive lots of \(\hat{\theta}_b\). Knowing that under large sample (the original sample) the bootstrap distribution will approximate the sampling distribution, we can estimate the variance of our estimator without knowing its closed form solution.

To sum up, bootstrapping is just another route to arrive at the sampling distribution of our estimator in order to measure how good our guess is against the population unknown. In the following section we are going to discuss the heuristics as why bootstrapping works.

2 Justification of Bootstrapping

To do bootstrap we essentially take the random sample \(X\) from the original population \(F\), and do the i.i.d. sampling from that sample as if the sample itself is another population with a distribution function \(\hat{F}\). Only in this time the population is finite and has a discrete distribution function, which is the empirical distribution function \(\hat{F}_n(X)\).

2.1 Empirical Distribution

From Wikipedia:

In statistics, an empirical distribution function is the distribution function associated with the empirical measure of a sample. This cumulative distribution function is a step function that jumps up by 1/n at each of the n data points. Its value at any specified value of the measured variable is the fraction of observations of the measured variable that are less than or equal to the specified value.

Specifically, the empirical distribution function (EDF) and empirical PDF of a sample \(x \overset{d}\sim F\) of size \(n\) can be written as:

\[ \begin{aligned} \hat{F}_n(x) &= \frac{1}{n} \sum_{i=1}^nI(x_i \leq x), \\ \hat{p}_n(x) &= \frac{d\hat{F}_n}{dx} = \frac{1}{n}, \end{aligned} \]

where \(I\) is an indicator function.

Intuitively and loosely speaking, \(\hat{F}_n\) is just an estimator for \(F\) the true population distribution. But here we are not guesing a single population parameter but the entire distribution. That is, we are not guesing a scalar but a function.3

2.2 Parameters as Functions of CDF

Why introducing the notion of EDF? To see the value, it’s better to step back and examine our best-friend parameter: population mean \(\mu = E(x)\). By definition the derivative of a CDF \(F\) is a PDF \(p\):

\[ \frac{dF(x)}{dx} = p(x). \]

Now we observe that the population mean can be re-written as:

\[ E(x) = \int xp(x)dx = \int xdF(x). \]

That is to say, population mean is indeed a function of CDF. We can easily extend this to the variance as a function of CDF as well, and to many other statistics.

Of course we don’t know CDF of the population. But we do know the EDF from our observed sample dataset, which itself is an estimator for CDF. This immediately gives us one estimator for population mean of the following form:

\[ \begin{aligned} E(x) \approx \int xd\hat{F}_n(x) &= \int x\hat{p}_n(x)dx \\ &= \sum_{i=1}^n x \cdot \frac{1}{n} \\ &= \frac{1}{n}\sum_{i=1}^nx_i, \end{aligned} \]

to guess the population mean.4

To no surprise, this estimator is exactly what we call the sample mean, proven to be a very good estimator for the population mean. But the idea generalizes to any estimator, as long as the estimator can be expressed as a function of CDF, which in turn will be approximated by EDF. In the literature such estimators are also referred to as statistical functionals.

More formally, under i.i.d. sample we have:

\[ \begin{aligned} E\big[\hat{F}_n(a)\big] &= \frac{1}{n}E\big[\sum_iI(x_i \leq a)\big] \\ &= \frac{1}{n}\sum_iE\big[I(x_i \leq a)\big] \\ &= \frac{1}{n} \cdot n \cdot \Pr(x \leq a) \\ &= F(a). \end{aligned} \]

Hence EDF is unbiased in every value \(a\). This means that any statistical functional which can be expressed as a linear function of EDF \(G(\hat{F}_n)\), will be unbiased as well:

\[ E\big[G(\hat{F}_n)\big] = G(F). \]

2.3 DKW Inequality

One thing remains unclear for those who are skeptical: How good does \(\hat{F}_n\) approximate \(F\)? Technically speaking, what is the variance of \(\hat{F}_n\)? The good news is, we do have a sound theoretical ground describing the bounds how close EDF will be to CDF. This is referred to as the Dvoretzky–Kiefer–Wolfowitz inequality:

\[ \Pr\big( \sup_{x \in R}\vert \hat{F}_n(x) - F(x) \vert > \epsilon \big) \leq 2e^{-2n\epsilon^2},\forall\epsilon > 0. \]

In plain words, EDF converges uniformly to CDF in \(n\) with exponential speed.5

So the intuition of why bootstrapping works lies in the following facts:

  1. Many estimators can be formulated as a linear function of CDF
  2. EDF is a good estimator for CDF

2.4 Cases Where Bootstrap Fails

There are well-known cases where bootstrapping is not able to approximate the sampling distribution of the estimator. Here are two of them:

  1. Min and max statistic (a.k.a. endpoint estimator)
  2. A population with infinite variance

They are both related to the applicability of CLT. The proof of the convergence of bootstrap distribution toward sampling distribution is based on CLT. Anything disqualifying CLT will result in the failure of bootstrapping.

3 Monte Carlo Bootstrapping

It is possible to derive the closed form solution for a bootstrap distribution. But this is kinda defeating the purpose of using bootstrap. The very reason we resort to bootstrapping is to bypass the need for a trackable derivation. So we will use Monte Carlo simulation to approximate the bootstrap distribution. Usually we are particularly interested in the variance of the bootstrap distribution.

Just a little recap. Given a particular estimator \(\hat{\theta}(\cdot)\) as a random variable, we are usually concerning about its expectation and variance. The expectation tells us whether the estimator is unbiased or not. The variance tells us how volatile our guess is, and also if it can be consistent–converging to the true parameter of interest.

By definition, the variance of a random variable \(\hat{\theta}\) is:

\[ \begin{aligned} Var(\hat{\theta}) &= E\big[(\hat{\theta} - E(\hat{\theta}))^2\big] \\ &= E(\hat{\theta}^2) - E(\hat{\theta})^2. \end{aligned} \]

Now to approximate the above result with Monte Carlo of \(M\) repetitions, we can simply do:

\[ Var(\hat{\theta}) \approx \frac{1}{M}\sum_m \hat{\theta}_m^2 - \bigg(\frac{1}{M}\sum_m \hat{\theta}_m\bigg)^2 , \]

where each \(\hat{\theta}_m\) is derived from a bootstrapped sample at the \(m\)-th repetition.

The above approximation holds thanks to the Law of Large Numbers (as \(M \rightarrow \infty\)):

\[ \begin{aligned} \frac{1}{M}\sum_m \hat{\theta}_m &\overset{p}\rightarrow E(\hat{\theta}), \\ \frac{1}{M}\sum_m \hat{\theta}_m^2 &\overset{p}\rightarrow E(\hat{\theta}^2). \end{aligned} \]

Remember that now we express the estimator \(\hat{\theta}(X)\) as function of EDF: \(\hat{\theta}(\hat{F}_n(X))\), i.e., a statistical functional. Now to draw random sample from this function we do i.i.d. sampling with replacement against \(\hat{F}_n\). Once the sample is constructed, we calculate the corresponding estimate value, and we do this for many many times to derive the entire distribution of the resulting estimates. That is, the simulated bootstrap distribution.

3.1 The Error of Measuring Error

There are two sources of error that can arise from this approach: simulation error and estimation error.

Simulation error occurred because we are using Monte Carlo finite repetitions. Increasing the number of repetitions can effectively decrease such error. Thanks to the wide-spread computing power nowadays, this is not a big issue at all.

Estimation error is the error due to statistical noise when we use \(\hat{F}_n\) to approximate \(F\) and by nature cannot be fully eliminated unless \(n\) goes to infinity. To reduce this error we will need a larger \(n\). Remember that the DKW inequality tells us that the convergence is at exponential speed in \(n\).

3.2 Hands-On: The Sample Mean

Let’s demonstrate the use of Monte Carlo bootstrapping with our best friend estimator: sample mean. Assume a Beta distribution as our pretendingly unknown population with the PDF:

beta_a <- 2
beta_b <- 10
mu_beta <- beta_a / (beta_a + beta_b)
var_beta <- (beta_a * beta_b) / ((beta_a + beta_b)^2*(beta_a + beta_b + 1))

beta_pdf <- function(x) dbeta(x, beta_a, beta_b)
curve(beta_pdf, from=0, to=1, ylab="Density",
      main=sprintf("(Unknown) Population Beta(%s, %s) PDF", beta_a, beta_b))

and the CDF:

beta_cdf <- function(x) pbeta(x, beta_a, beta_b)
curve(beta_cdf, from=0, to=1, ylab="Density",
      main=sprintf("(Unknown) Population Beta(%s, %s) CDF", beta_a, beta_b))

Now we draw a random sample with a fair size from the population. We plot the resulting histogram (probability mass function, or PMF):

set.seed(666)
n <- 5000
x <- rbeta(n, beta_a, beta_b)
hist(x, main="Probability Mass Function of X", probability=TRUE)

and the EDF:

plot(ecdf(x), main="Empirical Distribution Function of X", xlim=c(0, 1))

3.2.1 Analytical Solution

The variance of sample mean is analytically trackable, so indeed we don’t really need bootstrap to tackle this problem. But we can use it to verify if bootstrap can result in the correct approximation to our analytical solution.

Here is the derivation of the variance of sample mean, provided that the sample is i.i.d.:

\[ \begin{aligned} Var(\frac{1}{n}\sum_ix_i) &= \frac{1}{n^2}Var(\sum_ix_i) \\ &= \frac{1}{n^2}\sum_iVar(x_i) &\text{(due to independently distributed)} \\ &= \frac{1}{n^2}\cdot n Var(x) &\text{(due to identically distributed)} \\ &= \frac{Var(x)}{n}. \end{aligned} \]

Obviously the variance goes to zero as sample size goes to infinity. Hence sample mean as an estimator is consistent.

We can readily calculate the standard error of sample mean given our sample:

# Assume knowing population s.d. (the ground truth).
sqrt(var_beta / n)
[1] 0.001461763

But remember that we don’t know our population so there is no way we have access to the variance of population (the numerator). So instead we will almost always use sample variance to approximate the solution:

# Plugin sample standard deviation since population s.d. is unknown.
sd(x) / sqrt(n)
[1] 0.001489787

3.2.2 Monte Carlo with Multiple Samples

Now let’s say we don’t know the analytical solution. If we can draw more than just one sample dataset, we can use the resulting distribution to measure the error of our estiimator. Here is a corresponding Monte Carlo simulation to do exactly this:6

M <- 10000

mc_sampling <- function(M, n, print=TRUE) {
  mc_xbar <- rep(NA_real_, M)
  for ( i in seq_len(M) ) {
    xm <- rbeta(n, beta_a, beta_b)
    mc_xbar[i] <- mean(xm)
  }
  v <- sqrt(sum(mc_xbar^2) / M - (sum(mc_xbar) / M)^2)  # Or simply sd(mc_xbar).
  if ( print ) print(v)
  mc_xbar
}

mc_xbar <- mc_sampling(M, n)
[1] 0.001465021

The simulated distribution is the sampling distribution of our estimator. CLT tells us that the sampling distribution of sample mean is asymptotically Normal. Here without even knowing that, we can just use Monte Carlo to approximate the asymptotic sampling distribution. But this is hypothetical only. In reality we don’t have access to multiple random samples due to various resource constraints, so this approach only exists in theory.

Here we can plot the simulated estimates. It is a finite sample approximation to the sampling distribution. We also plot the theoretical limiting distribution given by CLT in blue curve.

x_mc <- seq(min(mc_xbar), max(mc_xbar), length=100) 
y_mc <- dnorm(x_mc, mu_beta, sqrt(var_beta / n))
hist(mc_xbar, main="Sampling Distribution (Sample Mean)", xlab="X", probability=TRUE)
lines(x_mc, y_mc, col="blue", lwd=2)

One can see how closely the simulated sampling distribution in histogram follows the theoretical limiting distribution in blue curve. When CLT applies, we can bypass the need to use multiple sample datasets and instead use only one to measure our statistical inference.

3.2.3 Monte Carlo Bootstrapping

Bootstrapping is yet another route to the sampling distribution. Even though we only have one sample dataset, and without applying CLT, we can use bootstrapping to generate as many resamples as we want. And this is totally feasible given enough computing power.

The same Monte Carlo setup, but now each sample is generated by bootstrapping from the only sample we have at hand:

M <- 10000

bs_sampling <- function(x, M, print=TRUE) {
  bs_xbar <- rep(NA_real_, M)
  for ( i in seq_len(M) ) {
    bs <- sample(x, size=length(x), replace=TRUE)  # The bootstrap.
    bs_xbar[i] <- mean(bs)
  }
  v <- sqrt(sum(bs_xbar^2) / M - (sum(bs_xbar) / M)^2)  # Or simply sd(bs_xbar).
  if ( print ) print(v)
  bs_xbar
}

bs_xbar <- bs_sampling(x, M)
[1] 0.001474795

The approximation is as good as if we hypothetically created multiple samples from the original population (as in the previous Monte Carlo exercise).

Below we plot all bootstrapped sample means. We also plot a green curve as the sampling distribution as if the original sample is the population. (That is, the original sample mean becomes the “population mean”.)

x_bs <- seq(min(bs_xbar), max(bs_xbar), length=100)
y_bs <- dnorm(x_bs, mean(x), sqrt(var_beta / n))
hist(bs_xbar, probability=TRUE,
     main="Distribution of Bootstrapped Sample Mean",
     sub=sprintf("Sample Size = %i", n), xlab="X")
lines(x_mc, y_mc, col="blue", lwd=2)
lines(x_bs, y_bs, col="green", lwd=2)

Notice that we also plot the blue curve as the limiting distribution of sample mean. Our previous Monte Carlo exercise has already confirmed this is the sampling distribution based on CLT. Clearly the bootstrapped estimates does NOT magically approximate the sampling distribution. There is a bias introduced by the original sample mean which is statistically deviated from the true mean. But they do share the same variance (shape). And since we are asking for the variance of our estimator, such bias does not affect our estimation of variance at all!

So the question is, can the resulting bootstrapped estimates approximate the sampling distribution in both shape and location? The answer is yes, but we need a large enough sample size. Let’s double up our original sample size and redo the entire exercise:

n2 <- 10000
x2 <- rbeta(n2, beta_a, beta_b)

mc_xbar2 <- mc_sampling(M, n2, print=FALSE)
bs_xbar2 <- bs_sampling(x2, M, print=FALSE)

x_mc2 <- seq(min(mc_xbar2), max(mc_xbar2), length=100)
y_mc2 <- dnorm(x_mc2, mu_beta, sqrt(var_beta / n2))
x_bs2 <- seq(min(bs_xbar2), max(bs_xbar2), length=100)
y_bs2 <- dnorm(x_bs2, mean(x2), sqrt(var_beta / n2))
hist(bs_xbar2, probability=TRUE,
     main="Distribution of Bootstrapped Sample Mean",
     sub=sprintf("Sample Size = %i", n2), xlab="X")
lines(x_mc2, y_mc2, col="blue", lwd=2)
lines(x_bs2, y_bs2, col="green", lwd=2)

Now the two distributions are getting closer to each other. We also observe that the requirement on sample size for bootstrap to approximate (both shape and location) the limiting distribution is much stricter than that for CLT to be applicable.7

To show this clearly, we run another Monte Carlo simulation with only sample size of 100, and we can see how well the sampling distribution is approximating the limiting distribution already:

n3 <- 100
x3 <- rbeta(n3, beta_a, beta_b)
mc_xbar3 <- mc_sampling(M, n3, print=FALSE)
x_mc3 <- seq(min(mc_xbar3), max(mc_xbar3), length=100) 
y_mc3 <- dnorm(x_mc3, mu_beta, sqrt(var_beta / n3))
hist(mc_xbar3, main="Sampling Distribution (Sample Mean)",
     sub=sprintf("Sample Size = %i", n3), xlab="X", probability=TRUE)
lines(x_mc3, y_mc3, col="blue", lwd=2)

This suggests that whenver we do have analytical solution for the limiting distribution of our estimator based on the corresponding CLT, we should just use that for our inference task instead of trying bootstrapping.8

So, yes, for a classical statistic like sample mean, there is not much value added using bootstrap. But it can always serve as a good educational case study.

Second-Order Correction

In our above comparison between bootstrap distribution and sampling distribution, what we actually plotted is \(\hat{\theta}\) v.s. \(\hat{\theta}_b\). But the approximation is better for \((\hat{\theta}_b - \hat{\theta})\) v.s. \((\hat{\theta} - \theta)\), and even better for \(\frac{(\hat{\theta}_b - \hat{\theta})}{se_b}\) v.s. \(\frac{(\hat{\theta} - \theta)}{se}\). The last one is referred to as second-order correction of bootstrap in the literature.

For our previous example if we plot instead the de-meaned version:

# Plot smooth density instead of histogram to make it easier to see the overlapping.
plot(density(bs_xbar - mean(x)), col="green",
     main="Monte Carlo Sampling Distribution v.s. Bootstrap Distribution",
     sub=sprintf("Sample Size = %i", n),
     xlab="X (De-Meaned)")
lines(density(mc_xbar - mu_beta), col="blue")
legend("topright",
       c(expression(hat(theta)[b] - hat(theta)),
         expression(hat(theta) - theta)),
       col=c("green", "blue"), pch=c(1, 1))

We see that the convergence is indeed quite good already.

3.2.4 Using Package boot

Rather than implementing the sampling procedure from scratch, we can also take advantage of the built-in package boot (Canty and Ripley 2019) in R to simplify our code:

library(boot)  # This is a built-in package.
bs_r <- boot(x, function(x, i) mean(x[i]), R=M, parallel="multicore")
print(bs_r)

ORDINARY NONPARAMETRIC BOOTSTRAP


Call:
boot(data = x, statistic = function(x, i) mean(x[i]), R = M, 
    parallel = "multicore")


Bootstrap Statistics :
     original        bias    std. error
t1* 0.1691994 -1.099041e-05  0.00148536

The bias reported by boot is simply the difference between the average of our simulated estimates and the original estimate:

mean(bs_r$t) - mean(x)
[1] -1.099041e-05

It should be very close to zero if nothing went wrong.

The returned object from boot also has a convenient plot method for visualization purpose:

plot(bs_r)

We can also use the function boot.array to check how many times a data point is resampled at each repetition. For example to check how many times the fisrt two examples are resampled at the first 10 repetitions:

boot.array(bs_r)[1:10,1:2]
      [,1] [,2]
 [1,]    0    1
 [2,]    2    1
 [3,]    0    1
 [4,]    0    0
 [5,]    0    1
 [6,]    2    1
 [7,]    1    1
 [8,]    0    0
 [9,]    1    0
[10,]    1    2

The row dimension is repetition and the column dimension is data.

3.2.5 Confidence Interval

Since we now have access to all simulated estimates, we can easily construct the confidence interval as well:

quantile(bs_r$t, probs=c(.025, .975))
     2.5%     97.5% 
0.1662635 0.1721149 

Of course for simple estimator such as sample mean, we do have the analytical solution for its confidence interval. But bootstrapping is able to do the approximation without knowing the solution.

3.2.6 Mean Squared Error

Another possible (though higly similar to variance) metric we may want to look at is the mean squared error (MSE). We can approximate MSE of our estimator using bootstrapping:

\[ \text{MSE}(\hat{\theta}) = \frac{1}{M}\sum_m(\hat{\theta}_m - \hat{\theta})^2. \]

So for the sample mean example, we can do:

# We use root mean squared error instead since the number is small.
sqrt(mean((bs_r$t - mean(x))^2))
[1] 0.001485327

3.3 Hands-On: T-Statistic

The t-statistic is:

\[ t = \frac{\bar{X} - \mu}{s / \sqrt{n}}, \]

where \(s\) is the standard deviation of sample \(X\).

The (two-sided) confidence interval for \(\mu\) is:

\[ \bar{X}\pm t_{(1 - \alpha/2)} \times \frac{s}{\sqrt{n}}, \]

where \(t_{(1 - \alpha/2)}\) is the t-statistic at confidence level \(\alpha\) with degree of freedom \(n - 1\).

For our demo example the groud truth of t-statistic is:

(mean(x) - mu_beta) / (sd(x) / sqrt(n))  # T-stat.
[1] 1.700033

Or we can use the built-in test function to also compute the confidence interval conveniently:

t.test(x, mu=mu_beta)

    One Sample t-test

data:  x
t = 1.7, df = 4999, p-value = 0.08919
alternative hypothesis: true mean is not equal to 0.1666667
95 percent confidence interval:
 0.1662787 0.1721200
sample estimates:
mean of x 
0.1691994 

Note that the above interval is not derived by pluging the unknown parameter \(\mu\), but based on the limiting distribution of t-statistic, the Student’s t-distribution. To verify this:

# Use qt to look up the value.
mean(x) + qt(c(.025, .975), df=n - 1) * (sd(x) / sqrt(n))
[1] 0.1662787 0.1721200

Instead we can use the bootstrapped t-statistic to approximate the unknown true t-statistic:

\[ t_b = \frac{\bar{X}_b - \bar{X}}{s_b / \sqrt{n}}. \]

Then all we need to do is to replace \(t\) with \(t_b\) in the equation:

\[ \bar{X}\pm t_{b{(1 - \alpha/2)}} \times \frac{s}{\sqrt{n}}. \]

The exact exercise follows.

# Re-define the bootstrapper since this time we need access to sd(x_b) as well.
t_bs_sampling <- function(x, M) {
  bs_xbar <- rep(NA_real_, M)
  bs_sd <- rep(NA_real_, M)
  for ( i in seq_len(M) ) {
    bs <- sample(x, size=length(x), replace=TRUE)  # The bootstrap.
    bs_xbar[i] <- mean(bs)
    bs_sd[i] <- sd(bs)  # Compute also standard deiviation for each resample.
  }
  list(xbar=bs_xbar, sd=bs_sd)
}

res <- t_bs_sampling(x, M)
bs_t <- (res$xbar - mean(x)) / (res$sd/sqrt(n))  # Bootstrap t-statistics.

# Bootstrapped confidence interval of mu using t-statistic.
mean(x) + (sd(x) / sqrt(n)) * quantile(bs_t, c(.025, .975))
     2.5%     97.5% 
0.1662145 0.1721219 

What we demonsatrate here is that the bootstrap distribution of t-statistic is also converging to the sampling distribution of t-statistic.

4 Bootstrapping for Regression Models

Now we understand the basic idea of bootstrapping. In this section we further discuss its application for a linear regression model.

We create some simulated data with a hypotehtical true model:

set.seed(777)
size <- 10000
num_feature <- 2

# Regressors (design matrix).
X <- rbeta(size * (num_feature + 1), beta_a, beta_b)
X <- cbind(1, matrix(X, ncol=num_feature + 1))
colnames(X) <- paste0("x_", 0:3)

# Noise.
e <- rnorm(size)

# True parameters.
true_coefs <- runif(num_feature + 2)
names(true_coefs) <- colnames(X)

# Response.
y <- (X %*% true_coefs + e)

# We will purposely omit one covariate to make the data a little bit "real".
Xy <- as.data.frame(X[,1:(num_feature + 1)])
Xy$y <- y

head(Xy)

The true parameters are:

print(true_coefs)
      x_0       x_1       x_2       x_3 
0.4783329 0.4621635 0.2008297 0.5402106 

The last parameter will be omitted in our model fit since we pretend as if it is not observable.

We fit the model and report the heteroskedasticity consistent standard error:9

library(lmtest)
library(sandwich)
lm_model <- lm(y ~ . - 1, data=Xy)
coeftest(lm_model, vcov=vcovHC(lm_model, type="HC0"))

t test of coefficients:

    Estimate Std. Error t value  Pr(>|t|)    
x_0 0.589523   0.024877 23.6977 < 2.2e-16 ***
x_1 0.364150   0.098327  3.7035 0.0002138 ***
x_2 0.070404   0.095387  0.7381 0.4604799    
---
Signif. codes:  0 '***' 0.001 '**' 0.01 '*' 0.05 '.' 0.1 ' ' 1

4.1 Case-Wise Bootstrap

The simpliest approach is to resample at the observation level. To speed up the repetitions we will directly compute the analytical solution rather than calling lm to avoid the overhead. Here is a quick single-threaded implementation from scratch:

ols <- function(X, y) {
  # Analytical solution for OLS estimator.
  solve(t(X) %*% X) %*% t(X) %*% y
}

bs_coefs <- matrix(NA_real_, nrow=1 + num_feature, ncol=M)
for ( i in seq_len(M) ) {
  Xy_b <- as.matrix(Xy[sample(size, replace=TRUE),])
  coefs_b <- ols(X=Xy_b[, 0:num_feature + 1], y=Xy_b[, ncol(Xy_b)])
  bs_coefs[,i] <- coefs_b
}

Instead let’s take advantage of boot to simplify and also speed up our code:

reg <- function(Xy, i) {
  Xy <- Xy[i,]
  X <- Xy[, 0:num_feature + 1]
  y <- Xy[, ncol(Xy)]
  solve(t(X) %*% X) %*% t(X) %*% y
}

bs_coefs <- boot(as.matrix(Xy), reg, R=M, parallel="multicore")
print(bs_coefs)

ORDINARY NONPARAMETRIC BOOTSTRAP


Call:
boot(data = as.matrix(Xy), statistic = reg, R = M, parallel = "multicore")


Bootstrap Statistics :
      original        bias    std. error
t1* 0.58952303 -4.014462e-04  0.02519527
t2* 0.36415043  1.791231e-03  0.09865505
t3* 0.07040356  9.224955e-05  0.09552950

To plot the bootstrap distribution of the 3rd coefficient:

plot(bs_coefs, index=3)

Case-wise bootstrapping implicitly assumes covariates are randomly assigned, which may not be justifiable if we believe our data is collected in a highly controlled manner. For example, data may be collected from an experimental design (so some of the features are directly set by the researcher). In such scenario we can resort to another approach: bootstrapping the model residuals.

4.2 Residual Bootstrap

If we’d like to hold our design matrix fixed, we can resample instead the residuals from the fitted model. Be aware that this implicitly assumes that the error term is identically distributed.

Anyway let’s do the exercise. Here is again the single-threaded implementation from scratch:

bs_coefs2 <- matrix(NA_real_, nrow=1 + num_feature, ncol=M)
yhat <- predict(lm_model, Xy)
for ( i in seq_len(M) ) {
  e_b <- sample(lm_model$residuals, size=size, replace=TRUE)  # Residual bootstrapping.
  y_b <- yhat + e_b
  bs_coefs2[,i] <- ols(X=X[, 0:num_feature + 1], y=y_b)
}

And with boot:

X_ <- X[, 0:num_feature + 1]  # Design matrix is fixed.
yhat <- predict(lm_model, Xy)

reg2 <- function(e, i) {
  y <- yhat + e[i]
  solve(t(X_) %*% X_) %*% t(X_) %*% y
}

bs_coefs2 <- boot(lm_model$residuals, reg2, R=M, parallel="multicore")
print(bs_coefs2)

ORDINARY NONPARAMETRIC BOOTSTRAP


Call:
boot(data = lm_model$residuals, statistic = reg2, R = M, parallel = "multicore")


Bootstrap Statistics :
      original        bias    std. error
t1* 0.58952303  0.0002952371  0.02477298
t2* 0.36415043 -0.0005145451  0.09641844
t3* 0.07040356 -0.0017440291  0.09556832

As one can see in our toy example the two approaches don’t have too much discrepancy.

Since residual boostrapping relies on the fitted residuals, the original model specification must be meaningful in the first place.

4.3 Bootstrapping for Time Series

Time series are usually autocorrelated. This means that either case-wise or residual bootstrapping won’t work because the underlying assumptions are heavily violated. To deal with autocorrelation a variety of block bootstrap methods have been proposed. The general idea is to resample at block-level instead of individual level to maintain the underlying autocorrelation structure. We will skip the detailed discussion here to keep the scope small.10

5 References

Canty, Angelo, and B. D. Ripley. 2019. Boot: Bootstrap R (S-Plus) Functions.

Davison, A. C., and D. V. Hinkley. 1997. Bootstrap Methods and Their Applications. Cambridge: Cambridge University Press. http://statwww.epfl.ch/davison/BMA/.

Efron, Bradley. 1992. “Bootstrap Methods: Another Look at the Jackknife.” In Breakthroughs in Statistics, 569–93. Springer.

SINGH, KEASAR. 1981. “On the Aysmptotic Accuracy of Efron’s Bootstrap.”

Zeileis, Achim. 2004. “Econometric Computing with HC and HAC Covariance Matrix Estimators.” Journal of Statistical Software 11 (10): 1–17. https://doi.org/10.18637/jss.v011.i10.

Zeileis, Achim, and Torsten Hothorn. 2002. “Diagnostic Checking in Regression Relationships.” R News 2 (3): 7–10. https://CRAN.R-project.org/doc/Rnews/.


  1. To emphasis one more time, for CLT to apply to sample mean, no assumption about population distribution is made except the finite second moment requirement, which is a fairly weak assumption.↩︎

  2. Though we didn’t discuss the technical details here, the proof of this convergence is indeed based on CLT.↩︎

  3. Here our wording is a bit Fisherian. Because in a Baysian point of view even a population parameter is a function (a random variable), not a constant scalar.↩︎

  4. This is based on the plug-in principle.↩︎

  5. Notation \(\sup\) denotes the supremum: The smallest number that is greater than or equal to every number in the set.↩︎

  6. Here we didn’t adjust the denominator to \(n-1\) in the formula we used. using function sd will do that by default. Theoretically the adjustment make the estimation unbiased. The effect is negligible though since we control the number of repetitions, which is usually a big enough number.↩︎

  7. Some researchers recommend \(n^2\) repetitions where \(n\) is the original sample size. Or \(n\ln n\) if \(n^2\) is prohibitive.↩︎

  8. Any old-school textbooks may mention the rule-of-thumb sample size of 30 as a generally accepted large enough number. This is over-simplification and can be dangerous in practice. Whether a sample size is big enough for CLT to have good approximation really depends on the nature of the population distribution, which unfortunately is unknown in the first place. There are some heuristics, though. For example the more symmetric the population the less sample size required to have a good approximation.↩︎

  9. Even though we know that our true model has homoskedastic error, the HC approach is more robust in practice.↩︎

  10. Block bootstrap is not limited to time series. It can also apply to data with spatial correlation.↩︎

LS0tCnRpdGxlOiAiQm9vdHN0cmFwIFNhbXBsaW5nIDEwMSIKc3VidGl0bGU6ICIiCmF1dGhvcjoKLSBuYW1lOiBLeWxlIENodW5nCiAgYWZmaWxpYXRpb246CmRhdGU6ICJgciBmb3JtYXQoU3lzLnRpbWUoKSwgJyVkICViICVZJylgIExhc3QgVXBkYXRlZCAoMTUgSmFuIDIwMjAgRmlyc3QgVXBsb2FkZWQpIgpvdXRwdXQ6CiAgaHRtbF9ub3RlYm9vazoKICAgIGhpZ2hsaWdodDogdGFuZ28KICAgIG51bWJlcl9zZWN0aW9uczogeWVzCiAgICB0aGVtZTogcGFwZXIKICAgIHRvYzogeWVzCiAgICB0b2NfZGVwdGg6IDMKICAgIHRvY19mbG9hdDogeWVzCiAgICBpbmNsdWRlczoKICAgICAgaW5faGVhZGVyOiAvdG1wL21ldGFfaGVhZGVyLmh0bWwKICBjb2RlX2Rvd25sb2FkOiB0cnVlCmJpYmxpb2dyYXBoeTogYm9vdHN0cmFwLmJpYgpub2NpdGU6IHwKICBAYm9vdDIKICBAbG10ZXN0CiAgQHNhbmR3aWNoCmxpbmstY2l0YXRpb25zOiB5ZXMKYWJzdHJhY3Q6IHwKICBXZSByZXZpZXcgTW9udGUgQ2FybG8gYm9vdHN0cmFwIHNhbXBsaW5nIGFwcHJvYWNoLCBhIHBvd2VyZnVsIHRlY2huaXF1ZSB0byBtZWFzdXJlIGVycm9yIG9mIGEgc3RhdGlzdGljYWwgaW5mZXJlbmNlIHRhc2sgd2hlbiB0aGUgdmFyaWFuY2Ugb2Ygb3VyIGVzdGltYXRvciBpcyBub3QgYW5hbHl0aWNhbGx5IHRyYWNrYWJsZS4gV2UgZXhwbGFpbiB3aHkgYm9vdHN0cmFwcGluZyB3b3JrcyB3aXRoIG1pbmltdW0gYW1vdW50IG9mIHRoZW9yZXRpY2FsIGRlcml2YXRpb24gYW5kIGRlbW9uc3RyYXRpb24gb2YgaGFuZHMtb24gZXhhbXBsZXMuCi0tLQoKYGBge3IgbWV0YSwgaW5jbHVkZT1GQUxTRX0KbWV0YV9oZWFkZXJfZmlsZSA8LSBmaWxlKCIvdG1wL21ldGFfaGVhZGVyLmh0bWwiKQoKIyBBZGQgb3BlbiBncmFwaCBtZXRhLgptZXRhIDwtIGMoCiAgJzxtZXRhIG5hbWU9ImF1dGhvciIgY29udGVudD0iS3lsZSBDaHVuZyI+JywKICAnPG1ldGEgcHJvcGVydHk9Im9nOnRpdGxlIiBjb250ZW50PSJCb290c3RyYXAgU2FtcGxpbmcgMTAxIj4nLAogICc8bWV0YSBwcm9wZXJ0eT0ib2c6dHlwZSIgY29udGVudD0iYXJ0aWNsZSI+JywKICAnPG1ldGEgcHJvcGVydHk9Im9nOnVybCIgY29udGVudD0iaHR0cHM6Ly9ldmVyZGFyay5naXRodWIuaW8vazkvbm90ZWJvb2tzL3N0YXRzL2Jvb3RzdHJhcC9ib290c3RyYXAubmIuaHRtbCI+JywKICAnPG1ldGEgcHJvcGVydHk9Im9nOmltYWdlIiBjb250ZW50PSJodHRwczovL2V2ZXJkYXJrLmdpdGh1Yi5pby9rOS9hc3NldHMvYm9vdC5wbmciPicsCiAgJzxtZXRhIHByb3BlcnR5PSJvZzpkZXNjcmlwdGlvbiIgY29udGVudD0iQSBkYXRhIHNjaWVuY2Ugbm90ZWJvb2sgYWJvdXQgYm9vdHN0cmFwIHNhbXBsaW5nLiI+JwopCmNvbnRlbnRzIDwtIG1ldGEKCiMgQWRkIEdpdGh1YiBjb3JuZXIuCmdpdGh1Yl9jb3JuZXJfc3ZnIDwtICIuLi8uLi8uLi9hc3NldHMvZ2l0aHViX2Nvcm5lci5odG1sIgpnaXRodWJfY29ybmVyX2NvbmYgPC0gbGlzdChnaXRodWJfbGluaz0iaHR0cHM6Ly9naXRodWIuY29tL2V2ZXJkYXJrL2s5L3RyZWUvbWFzdGVyL25vdGVib29rcy9zdGF0cy9ib290c3RyYXAiKQpjb250ZW50cyA8LSBjKGNvbnRlbnRzLCBzdHJpbmdyOjpzdHJfaW50ZXJwKHJlYWRMaW5lcyhnaXRodWJfY29ybmVyX3N2ZyksIGdpdGh1Yl9jb3JuZXJfY29uZikpCndyaXRlTGluZXMoY29udGVudHMsIG1ldGFfaGVhZGVyX2ZpbGUpCgpjbG9zZShtZXRhX2hlYWRlcl9maWxlKQpgYGAKCiMgU3RhdGlzdGljYWwgSW5mZXJlbmNlOiBBIFF1aWNrIE92ZXJ2aWV3CgpBdCB0aGUgY29yZSBvZiBzdGF0aXN0aWNhbCBpbmZlcmVuY2UgaXMgYWJvdXQgdG8gdXNlIGFuIGVzdGltYXRvciAkXGhhdHtcdGhldGF9KFgpJCB0byBndWVzcyB0aGUgdW5rbm93biB2YWx1ZSBvZiAkXHRoZXRhJCBhIHBvcHVsYXRpb24gcGFyYW1ldGVyIG9mIGludGVyZXN0IGJhc2VkIG9uIGEgcmFuZG9tIHNhbXBsZSBkYXRhc2V0ICRYJCBkcmF3biBmcm9tIHRoYXQgcG9wdWxhdGlvbi4KVGhlIG1vc3QgY29tbW9uIGNhc2Ugb2YgJFx0aGV0YSQgd2lsbCBiZSB0aGUgcG9wdWxhdGlvbiBtZWFuICRcbXUgPSBFKHgpJCB3aGVyZSAkeCQgZGVub3RlcyB0aGUgcG9wdWxhdGlvbiBmb2xsb3dpbmcgYW4gdW5rbm93biBkaXN0cmlidXRpb24gJHggXG92ZXJzZXR7ZH1cc2ltIEYkLgpPdGhlciBwb3B1bGFyIHBhcmFtZXRlcnMgY2FuIGJlIGEgbWVkaWFuLAphIHZhcmlhbmNlLAphIGNvbmZpZGVuY2UgaW50ZXJ2YWwgb2YgdGhlIG1lYW4sCm9yIGEgcmVncmVzc2lvbiBtb2RlbCBjb2VmZmljaWVudCwKYSBjb25maWRlbmNlIGludGVydmFsIG9mIHRoZSByZWdyZXNzaW9uIGNvZWZmaWNpZW50LCAuLi4sIGV0Yy4KCiMjIFNhbXBsaW5nIERpc3RyaWJ1dGlvbgoKSG93IGRvIHdlIGtub3cgb3VyIGd1ZXNzIChvdXIgZXN0aW1hdG9yKSBpcyBhIGdvb2Qgb25lPwpUaGF0IGlzLApob3cgZG8gd2UgbWVhc3VyZSB0aGUgZXJyb3Igb2Ygb3VyIGVzdGltYXRvciBpbiBzdGF0aXN0aWNhbCBpbmZlcmVuY2UsCndpdGhvdXQga25vd2luZyB0aGUgZ3JvdW5kIHRydXRoIG9mIHRoZSBwb3B1bGF0aW9uPwpUaGUgZGlzdHJpYnV0aW9uIGZ1bmN0aW9uIG9mIHBvcHVsYXRpb24gJEYkIGlzIHVua25vd24uCkFzIGEgcmVzdWx0LAp0byBtYWtlIG91ciBzdGF0aXN0aWNhbCBpbmZlcmVuY2UgZnJvbSBhIHNhbXBsZSBkYXRhc2V0IHdlIHJlbHkgb24gdGhlIFtDZW50cmFsIExpbWl0IFRoZW9yZW1dKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0NlbnRyYWxfbGltaXRfdGhlb3JlbSkuCkluIGl0cyB2YW5pbGxhIHZlcnNpb24gQ0xUIG9ubHkgcmVxdWlyZXMgdGhlIHBvcHVsYXRpb24gdG8gaGF2ZSBmaW5pdGUgc2Vjb25kIG1vbWVudCBhbmQgb3VyIHNhbXBsZSBkYXRhc2V0IGlzIGlkZW50aWNhbGx5IGFuZCBpbmRlcGVuZGVudGx5IGRpc3RyaWJ1dGVkIChpLmkuZC4pLgpJdCBhbGxvd3MgdXMgdG8gZGVyaXZlIHRoZSBbbGltaXRpbmcgZGlzdHJpYnV0aW9uXShodHRwczovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9Bc3ltcHRvdGljX2Rpc3RyaWJ1dGlvbikgKGFzICRuIFxyaWdodGFycm93IFxpbmZ0eSQpIG9mIHRoZSBbKnNhbXBsaW5nIGRpc3RyaWJ1dGlvbipdKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL1NhbXBsaW5nX2Rpc3RyaWJ1dGlvbikgb2YgYSBzYW1wbGUgbWVhbiwKd2hpY2ggaW4gdHVybiBjYW4gYmUgdXNlZCB0byBtZWFzdXJlIHRoZSBlcnJvciBvZiBvdXIgZ3Vlc3MgJFxoYXR7XHRoZXRhfSA9IFxmcmFjezF9e259XHN1bV9peF9pJCB0byB0aGUgdW5rbm93biBwb3B1bGF0aW9uIHBhcmFtZXRlciAkXHRoZXRhID0gXG11JC4KClRvIGJlIGNvbmNyZXRlLAp0aGUgdmFuaWxsYSBDTFQgaW5kaWNhdGVzIHRoYXQgdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBvZiBzYW1wbGUgbWVhbiAkXGJhcntYfSA9IFxmcmFjezF9e259XHN1bV9peF9pJCBoYXMgdGhlIGZvbGxvd2luZyBsaW1pdGluZyBkaXN0cmlidXRpb246CgokJApcYmFye1h9X24gXG92ZXJzZXR7ZH1ccmlnaHRhcnJvdyBcdGV4dHtOb3JtYWx9KFxtdSwgXGZyYWN7XHNpZ21hfXtcc3FydHtufX0pLAokJAoKd2hlcmUgJFxtdSQgaXMgdGhlIHBvcHVsYXRpb24gbWVhbiBhbmQgJFxzaWdtYSQgdGhlIHBvcHVsYXRpb24gc3RhbmRhcmQgZGV2aWF0aW9uLgpUaGlzIGlzIGVsZWdhbnQgc2luY2UgTm9ybWFsIGRpc3RyaWJ1dGlvbiBpcyBtYXRoZW1hdGljYWxseSB2ZXJ5IGZyaWVuZGx5IHRvIGRlYWwgd2l0aC4KCklkZWFsbHkgd2UnZCBsaWtlIHRvIGNyZWF0ZSBtdWx0aXBsZSAoYXMgbWFueSBhcyBwb3NzaWJsZSkgcmFuZG9tIHNhbXBsZSBkYXRhc2V0cyB0byBtZWFzdXJlIG91ciBndWVzcyBhZ2FpbnN0IHRoZSBwb3B1bGF0aW9uLgpJbiByZWFsaXR5IGR1ZSB0byByZXNvdXJjZSBjb25zdHJhaW50IHdlIHVzdWFsbHkgZW5kIHVwIHdpdGggb25lIGFuZCBvbmx5IHN1Y2ggc2FtcGxlIGRhdGFzZXQuCkJ1dCBiYXNlZCBvbiBDTFQgd2UgaGF2ZSBhIHNvbGlkIHRoZW9yZXRpY2FsIGdyb3VuZCB0byBtZWFzdXJlIG91ciBndWVzcyAod2l0aCBpdHMgYXN5bXB0b3RpYyBzYW1wbGluZyBkaXN0cmlidXRpb24pIGV2ZW4gZnJvbSBvbmx5IG9uZSBzYW1wbGUgb2Ygc2l6ZSAkbiQsCnByb3ZpZGVkIHRoYXQgJG4kIGlzIGxhcmdlIGVub3VnaC4KCkRpZmZlcmVudCB2ZXJzaW9ucyBvZiBDTFQgY2FuIGJlIGZvcm11bGF0ZWQgYmFzZWQgb24gdGhlIGVzdGltYXRvciB3ZSBhcmUgdXNpbmcsCmluIG9yZGVyIHRvIGRlcml2ZSB0aGUgYXlzbXB0b3RpYyBzYW1wbGluZyBkaXN0cmlidXRpb24gb2YgdGhhdCBlc3RpbWF0b3IuClNvIHdlIGFsc28gaGF2ZSBDTFQgYXBwbGljYWJsZSB0bywgc2F5LCBhIHJlZ3Jlc3Npb24gbW9kZWwgY29lZmZpY2llbnQuCkxldCdzIGV4YWN0bHkgaG93IHdlIHRlc3QgdGhlIG51bGwgZWZmZWN0IG9mIGEgcmVncmVzc29yIG9uIHRoZSByZWdyZXNzYW5kLgpJbiBnZW5lcmFsLAphbnkgZXN0aW1hdG9yIGluIGEgZm9ybSBvZiB3ZWlnaHRlZCBhdmVyYWdpbmcgY2FuIGJlIGFkYXB0ZWQgdG8gQ0xULgoKVGhlIHVzdWFsIHdvcmtmbG93IG9mIHN0YXRpc3RpY2FsIGluZmVyZW5jZSB3aWxsIGJlIHRvIHVzZSBDTFQgdG8gZGVyaXZlIHRoZSBhbmFseXRpY2FsIHNvbHV0aW9uIG9mIHRoZSBhc3ltcHRvdGljIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBvZiB0aGUgZXN0aW1hdG9yLgpCdXQgdGhpcyBpcyBub3QgYWx3YXlzIGFjaGlldmFibGUuClRoZSBtb3JlIGNvbXBsaWNhdGVkIHRoZSBlc3RpbWF0b3IgdGhlIGhhcmRlciBpdCBjYW4gYmUgYW5hbHl6ZWQgaW4gYSB0cmFja2FibGUgd2F5LgpBbmQgc29tZSBlc3RpbWF0b3JzIGNhbiBiZSBoYXJkZXIgdG8gZGVhbCB3aXRoIGV2ZW4gaWYgdGhleSBhcmUgc2ltcGxlIGluIHRoZWlyIG93bi4KT25lIHN1Y2ggd2VsbC1rbm93biBleGFtcGxlIGlzIHRoZSBzYW1wbGUgbWVkaWFuICh0byBndWVzcyB0aGUgcG9wdWxhdGlvbiBtZWRpYW4gb2YgY291cnNlKSwKd2hpY2ggcmVxdWlyZXMgb3JkZXIgc3RhdGlzdGljcyBjb21lIHRvIHBsYXkuCkluZGVlZCB0aGVyZSBpcyBubyBjbG9zZWQgZm9ybSBzb2x1dGlvbiBmb3IgdGhlIHZhcmlhbmNlIG9mIHNhbXBsZSBtZWRpYW4gdW5sZXNzIHdlIGFzc3VtZSB0aGUgcG9wdWxhdGlvbiBkaXN0cmlidXRpb24gdG8gYmUgYSBjZXJ0YWluIGtpbmQuCl5bVG8gZW1waGFzaXMgb25lIG1vcmUgdGltZSwKZm9yIENMVCB0byBhcHBseSB0byBzYW1wbGUgbWVhbiwKbm8gYXNzdW1wdGlvbiBhYm91dCBwb3B1bGF0aW9uIGRpc3RyaWJ1dGlvbiBpcyBtYWRlIGV4Y2VwdCB0aGUgZmluaXRlIHNlY29uZCBtb21lbnQgcmVxdWlyZW1lbnQsCndoaWNoIGlzIGEgZmFpcmx5IHdlYWsgYXNzdW1wdGlvbi5dCgpUaGlzIGlzIHdoZXJlIGJvb3RzdHJhcCBzYW1wbGluZyBjb21lcyB0byBzaGluZS4KVGhlIGlkZWEgb2YgYm9vc3RyYXAgc2FtcGxpbmcgaXMgdG8gdXNlIHRoZSBzYW1wbGUgYW5kIHRoZSBvbmx5IHNhbXBsZSBhcyBhICpzdXJyb2dhdGUgcG9wdWxhdGlvbiosCnRvIGFwcHJveGltYXRlIHRoZSB1bmRlcmx5aW5nIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBvZiBvdXIgZXN0aW1hdG9yIHdoaWNoIG90aGVyd2lzZSBpcyB1bnRyYWNrYWJsZS4KCiMjIEJvb3RzdHJhcCBEaXN0cmlidXRpb24KCkBlZnJvbjE5OTJib290c3RyYXAgcHJvcG9zZSB0aGUgYm9vdHN0cmFwcGluZyB0ZWNobmlxdWUgYXMgYSBzb2x1dGlvbiB0byBlc3RpbWF0ZSB0aGUgdmFyaWFuY2UgKG9yIHRoZSBjb25maWRlbmNlIGludGVydmFsKSBvZiBhIGdpdmVuIGVzdGltYXRvciwKc3VjaCB0aGF0IHdlIGNhbiBkcmF3IGNvbmNsdXNpb24gYWJvdXQgdGhlIHF1YWlsaXR5IG9mIG91ciBpbmZlcmVuY2UsCmVzcGVjaWFsbHkgd2hlbiB0aGVyZSBpcyBubyBhbmFseXRpY2FsIHNvbHV0aW9uIHRvIGRlcml2ZSB0aGUgdmFyaWFuY2Ugb2YgdGhhdCBlc3RpbWF0b3IuCgpCb290c3RyYXBwaW5nIGNhbiBiZSBzaW1wbHkgZGVmaW5lZCBhcyBkcmF3aW5nIGkuaS5kLiBzYW1wbGUgb2YgdGhlIHNhbWUgc2l6ZSAkbiQgZnJvbSBhIGdpdmVuIHNhbXBsZS4KSW4gc29tZSBsaXRlcmF0dXJlcyB0aGlzIGlzIGFsc28gY2FsbGVkIHRoZSAqcmVzYW1wbGUqLgpUbyBzdHJpY3RseSBmb2xsb3cgaS5pLmQuIHRoZSBzYW1wbGluZyBtdXN0IGJlIGRvbmUgKndpdGggcmVwbGFjZW1lbnQqLgoKV2l0aCBlbm91Z2ggY29tcHV0aW5nIHBvd2VyLAp3ZSBjYW4gZ2VuZXJhdGUgYXMgbWFueSByZXNhbXBsZXMgJFhfYiQgYXMgd2Ugd2FudCBhbmQgZm9yIGVhY2ggcmVzYW1wbGUgd2UgY2FsY3VsYXRlIHRoZSB2YWx1ZSBvZiBvdXIgZXN0aW1hdG9yICRcaGF0e1x0aGV0YX1fYiA9IFxoYXR7XHRoZXRhfShYX2IpJCAodGVybWVkIGFzIHRoZSAqZXN0aW1hdGUqKS4KVGhlIHJlc3VsdGluZyBkaXN0cmlidXRpb24gb2YgYm9vdHN0cmFwcGVkIGVzdGltYXRlcyBmcm9tIGEgZ2l2ZW4gc2FtcGxlICRYJCBpcyByZWZlcnJlZCB0byBhcyB0aGUgKmJvb3RzdHJhcCBkaXN0cmlidXRpb24qLgoKSXQgaGFzIGJlZW4gcHJvdmVuIHRoYXQgdGhlIGxpbWl0aW5nIGRpc3RyaWJ1dGlvbiBvZiBhIGJvb3RzdHJhcCBkaXN0cmlidXRpb24gaXMgYWN0dWFsbHkgdGhlIHNhbWUgYXMgdGhhdCBvZiB0aGUgc2FtcGxpbmcgZGlzdHJpYnV0aW9uLApmb3IgYSB2YXJpZXR5IG9mIGVzdGltYXRvcnMgd2lkZWx5IHVzZWQgZm9yIGluZmVyZW5jZS4gW0BzaW5naDE5ODFhc3ltcHRvdGljXQoKVG8gYmUgY2xlYXIgbGV0J3MgcHV0IGl0IGluIG5vdGF0aW9uOgoKJCQKXHVuZGVyYnJhY2V7KFxoYXR7XHRoZXRhfV9iIC0gXGhhdHtcdGhldGF9KX1fXHRleHR7Qm9vdHN0cmFwIERpc3RyaWJ1dGlvbn0KXG92ZXJzZXR7ZH1ccmlnaHRhcnJvdwpcdW5kZXJicmFjZXsoXGhhdHtcdGhldGF9IC0gXHRoZXRhKSBcdnBoYW50b217XGhhdHtcdGhldGF9X2J9fV9cdGV4dHtTYW1wbGluZyBEaXN0cmlidXRpb259LAokJAoKd2hlcmUgJFxoYXR7XHRoZXRhfSQgaXMgdGhlIGVzdGltYXRlIGRlcml2ZWQgZnJvbSBvdXIgb25seSBzYW1wbGUgdG8gaW5mZXIgdGhlIHBhcmFtZXRlciAkXHRoZXRhJCwKYW5kICRcaGF0e1x0aGV0YX1fYiQgaXMgdGhlIGVzdGltYXRlIGRlcml2ZWQgZnJvbSB0aGUgYm9vdHN0cmFwIHNhbXBsZSBvdXQgb2YgdGhlIG9yaWdpbmFsIHNhbXBsZS4KXltUaG91Z2ggd2UgZGlkbid0IGRpc2N1c3MgdGhlIHRlY2huaWNhbCBkZXRhaWxzIGhlcmUsCnRoZSBwcm9vZiBvZiB0aGlzIGNvbnZlcmdlbmNlIGlzIGluZGVlZCBiYXNlZCBvbiBDTFQuXQoKRHVlIHRvIHByYWN0aWNhbCByZWFzb24gd2Ugb25seSBoYXZlIG9uZSBzYW1wbGUgdG8gZGVyaXZlICRcaGF0e1x0aGV0YX0kLApidXQgd2UgY2FuIGRvIGFzIG1hbnkgYXMgYm9vdHN0cmFwIHNhbXBsZXMgZnJvbSB0aGF0IHNhbXBsZSB0byBkZXJpdmUgbG90cyBvZiAkXGhhdHtcdGhldGF9X2IkLgpLbm93aW5nIHRoYXQgdW5kZXIgbGFyZ2Ugc2FtcGxlICh0aGUgb3JpZ2luYWwgc2FtcGxlKSB0aGUgYm9vdHN0cmFwIGRpc3RyaWJ1dGlvbiB3aWxsIGFwcHJveGltYXRlIHRoZSBzYW1wbGluZyBkaXN0cmlidXRpb24sCndlIGNhbiBlc3RpbWF0ZSB0aGUgdmFyaWFuY2Ugb2Ygb3VyIGVzdGltYXRvciB3aXRob3V0IGtub3dpbmcgaXRzIGNsb3NlZCBmb3JtIHNvbHV0aW9uLgoKVG8gc3VtIHVwLApib290c3RyYXBwaW5nIGlzIGp1c3QgYW5vdGhlciByb3V0ZSB0byBhcnJpdmUgYXQgdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBvZiBvdXIgZXN0aW1hdG9yIGluIG9yZGVyIHRvIG1lYXN1cmUgaG93IGdvb2Qgb3VyIGd1ZXNzIGlzIGFnYWluc3QgdGhlIHBvcHVsYXRpb24gdW5rbm93bi4KSW4gdGhlIGZvbGxvd2luZyBzZWN0aW9uIHdlIGFyZSBnb2luZyB0byBkaXNjdXNzIHRoZSBoZXVyaXN0aWNzIGFzIHdoeSBib290c3RyYXBwaW5nIHdvcmtzLgoKIyBKdXN0aWZpY2F0aW9uIG9mIEJvb3RzdHJhcHBpbmcKClRvIGRvIGJvb3RzdHJhcCB3ZSBlc3NlbnRpYWxseSB0YWtlIHRoZSByYW5kb20gc2FtcGxlICRYJCBmcm9tIHRoZSBvcmlnaW5hbCBwb3B1bGF0aW9uICRGJCwKYW5kIGRvIHRoZSBpLmkuZC4gc2FtcGxpbmcgZnJvbSB0aGF0IHNhbXBsZSAqYXMgaWYqIHRoZSBzYW1wbGUgaXRzZWxmIGlzIGFub3RoZXIgcG9wdWxhdGlvbiB3aXRoIGEgZGlzdHJpYnV0aW9uIGZ1bmN0aW9uICRcaGF0e0Z9JC4KT25seSBpbiB0aGlzIHRpbWUgdGhlIHBvcHVsYXRpb24gaXMgZmluaXRlIGFuZCBoYXMgYSBkaXNjcmV0ZSBkaXN0cmlidXRpb24gZnVuY3Rpb24sCndoaWNoIGlzIHRoZSAqZW1waXJpY2FsIGRpc3RyaWJ1dGlvbiBmdW5jdGlvbiogJFxoYXR7Rn1fbihYKSQuCgojIyBFbXBpcmljYWwgRGlzdHJpYnV0aW9uCgpGcm9tIFtXaWtpcGVkaWFdKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0VtcGlyaWNhbF9kaXN0cmlidXRpb25fZnVuY3Rpb24pOgoKPkluIHN0YXRpc3RpY3MsCmFuIGVtcGlyaWNhbCBkaXN0cmlidXRpb24gZnVuY3Rpb24gaXMgdGhlIGRpc3RyaWJ1dGlvbiBmdW5jdGlvbiBhc3NvY2lhdGVkIHdpdGggdGhlIGVtcGlyaWNhbCBtZWFzdXJlIG9mIGEgc2FtcGxlLgpUaGlzIGN1bXVsYXRpdmUgZGlzdHJpYnV0aW9uIGZ1bmN0aW9uIGlzIGEgc3RlcCBmdW5jdGlvbiB0aGF0IGp1bXBzIHVwIGJ5IDEvbiBhdCBlYWNoIG9mIHRoZSBuIGRhdGEgcG9pbnRzLgpJdHMgdmFsdWUgYXQgYW55IHNwZWNpZmllZCB2YWx1ZSBvZiB0aGUgbWVhc3VyZWQgdmFyaWFibGUgaXMgdGhlIGZyYWN0aW9uIG9mIG9ic2VydmF0aW9ucyBvZiB0aGUgbWVhc3VyZWQgdmFyaWFibGUgdGhhdCBhcmUgbGVzcyB0aGFuIG9yIGVxdWFsIHRvIHRoZSBzcGVjaWZpZWQgdmFsdWUuCgpTcGVjaWZpY2FsbHksCnRoZSBlbXBpcmljYWwgZGlzdHJpYnV0aW9uIGZ1bmN0aW9uIChFREYpIGFuZCBlbXBpcmljYWwgUERGIG9mIGEgc2FtcGxlICR4IFxvdmVyc2V0e2R9XHNpbSBGJCBvZiBzaXplICRuJCBjYW4gYmUgd3JpdHRlbiBhczoKCiQkClxiZWdpbnthbGlnbmVkfQpcaGF0e0Z9X24oeCkgJj0gXGZyYWN7MX17bn0gXHN1bV97aT0xfV5uSSh4X2kgXGxlcSB4KSwgXFwKXGhhdHtwfV9uKHgpICY9IFxmcmFje2RcaGF0e0Z9X259e2R4fSA9IFxmcmFjezF9e259LApcZW5ke2FsaWduZWR9CiQkCgp3aGVyZSAkSSQgaXMgYW4gaW5kaWNhdG9yIGZ1bmN0aW9uLgoKSW50dWl0aXZlbHkgYW5kIGxvb3NlbHkgc3BlYWtpbmcsCiRcaGF0e0Z9X24kIGlzIGp1c3QgYW4gZXN0aW1hdG9yIGZvciAkRiQgdGhlIHRydWUgcG9wdWxhdGlvbiBkaXN0cmlidXRpb24uCkJ1dCBoZXJlIHdlIGFyZSBub3QgZ3Vlc2luZyBhIHNpbmdsZSBwb3B1bGF0aW9uIHBhcmFtZXRlciBidXQgdGhlIGVudGlyZSBkaXN0cmlidXRpb24uClRoYXQgaXMsCndlIGFyZSBub3QgZ3Vlc2luZyBhIHNjYWxhciBidXQgYSBmdW5jdGlvbi4KXltIZXJlIG91ciB3b3JkaW5nIGlzIGEgYml0ICpGaXNoZXJpYW4qLgpCZWNhdXNlIGluIGEgQmF5c2lhbiBwb2ludCBvZiB2aWV3IGV2ZW4gYSBwb3B1bGF0aW9uIHBhcmFtZXRlciBpcyBhIGZ1bmN0aW9uIChhIHJhbmRvbSB2YXJpYWJsZSksCm5vdCBhIGNvbnN0YW50IHNjYWxhci5dCgojIyBQYXJhbWV0ZXJzIGFzIEZ1bmN0aW9ucyBvZiBDREYKCldoeSBpbnRyb2R1Y2luZyB0aGUgbm90aW9uIG9mIEVERj8KVG8gc2VlIHRoZSB2YWx1ZSwKaXQncyBiZXR0ZXIgdG8gc3RlcCBiYWNrIGFuZCBleGFtaW5lIG91ciBiZXN0LWZyaWVuZCBwYXJhbWV0ZXI6CnBvcHVsYXRpb24gbWVhbiAkXG11ID0gRSh4KSQuCkJ5IGRlZmluaXRpb24gdGhlIGRlcml2YXRpdmUgb2YgYSBDREYgJEYkIGlzIGEgUERGICRwJDoKCiQkClxmcmFje2RGKHgpfXtkeH0gPSBwKHgpLgokJAoKTm93IHdlIG9ic2VydmUgdGhhdCB0aGUgcG9wdWxhdGlvbiBtZWFuIGNhbiBiZSByZS13cml0dGVuIGFzOgoKJCQKRSh4KSA9IFxpbnQgeHAoeClkeCA9IFxpbnQgeGRGKHgpLgokJAoKVGhhdCBpcyB0byBzYXksCnBvcHVsYXRpb24gbWVhbiBpcyBpbmRlZWQgKmEgZnVuY3Rpb24gb2YgQ0RGKi4KV2UgY2FuIGVhc2lseSBleHRlbmQgdGhpcyB0byB0aGUgdmFyaWFuY2UgYXMgYSBmdW5jdGlvbiBvZiBDREYgYXMgd2VsbCwKYW5kIHRvIG1hbnkgb3RoZXIgc3RhdGlzdGljcy4KCk9mIGNvdXJzZSB3ZSBkb24ndCBrbm93IENERiBvZiB0aGUgcG9wdWxhdGlvbi4KQnV0IHdlIGRvIGtub3cgdGhlIEVERiBmcm9tIG91ciBvYnNlcnZlZCBzYW1wbGUgZGF0YXNldCwKd2hpY2ggaXRzZWxmIGlzIGFuIGVzdGltYXRvciBmb3IgQ0RGLgpUaGlzIGltbWVkaWF0ZWx5IGdpdmVzIHVzIG9uZSBlc3RpbWF0b3IgZm9yIHBvcHVsYXRpb24gbWVhbiBvZiB0aGUgZm9sbG93aW5nIGZvcm06CgokJApcYmVnaW57YWxpZ25lZH0KRSh4KSBcYXBwcm94IFxpbnQgeGRcaGF0e0Z9X24oeCkKJj0gXGludCB4XGhhdHtwfV9uKHgpZHggXFwKJj0gXHN1bV97aT0xfV5uIHggXGNkb3QgXGZyYWN7MX17bn0gXFwKJj0gXGZyYWN7MX17bn1cc3VtX3tpPTF9Xm54X2ksClxlbmR7YWxpZ25lZH0KJCQKCnRvIGd1ZXNzIHRoZSBwb3B1bGF0aW9uIG1lYW4uCl5bVGhpcyBpcyBiYXNlZCBvbiB0aGUgW3BsdWctaW4gcHJpbmNpcGxlXShodHRwczovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9QbHVnLWluX3ByaW5jaXBsZSkuXQoKVG8gbm8gc3VycHJpc2UsCnRoaXMgZXN0aW1hdG9yIGlzIGV4YWN0bHkgd2hhdCB3ZSBjYWxsIHRoZSAqc2FtcGxlIG1lYW4qLApwcm92ZW4gdG8gYmUgYSB2ZXJ5IGdvb2QgZXN0aW1hdG9yIGZvciB0aGUgcG9wdWxhdGlvbiBtZWFuLgpCdXQgdGhlIGlkZWEgZ2VuZXJhbGl6ZXMgdG8gKmFueSogZXN0aW1hdG9yLAphcyBsb25nIGFzIHRoZSBlc3RpbWF0b3IgY2FuIGJlIGV4cHJlc3NlZCBhcyBhIGZ1bmN0aW9uIG9mIENERiwKd2hpY2ggaW4gdHVybiB3aWxsIGJlIGFwcHJveGltYXRlZCBieSBFREYuCkluIHRoZSBsaXRlcmF0dXJlIHN1Y2ggZXN0aW1hdG9ycyBhcmUgYWxzbyByZWZlcnJlZCB0byBhcyAqc3RhdGlzdGljYWwgZnVuY3Rpb25hbHMqLgoKTW9yZSBmb3JtYWxseSwKdW5kZXIgaS5pLmQuIHNhbXBsZSB3ZSBoYXZlOgoKJCQKXGJlZ2lue2FsaWduZWR9CkVcYmlnW1xoYXR7Rn1fbihhKVxiaWddCiY9IFxmcmFjezF9e259RVxiaWdbXHN1bV9pSSh4X2kgXGxlcSBhKVxiaWddIFxcCiY9IFxmcmFjezF9e259XHN1bV9pRVxiaWdbSSh4X2kgXGxlcSBhKVxiaWddIFxcCiY9IFxmcmFjezF9e259IFxjZG90IG4gXGNkb3QgXFByKHggXGxlcSBhKSBcXAomPSBGKGEpLgpcZW5ke2FsaWduZWR9CiQkCgpIZW5jZSBFREYgaXMgKnVuYmlhc2VkKiBpbiBldmVyeSB2YWx1ZSAkYSQuClRoaXMgbWVhbnMgdGhhdCBhbnkgc3RhdGlzdGljYWwgZnVuY3Rpb25hbCB3aGljaCBjYW4gYmUgZXhwcmVzc2VkIGFzIGEgbGluZWFyIGZ1bmN0aW9uIG9mIEVERiAkRyhcaGF0e0Z9X24pJCwKd2lsbCBiZSB1bmJpYXNlZCBhcyB3ZWxsOgoKJCQKRVxiaWdbRyhcaGF0e0Z9X24pXGJpZ10gPSBHKEYpLgokJAoKIyMgREtXIEluZXF1YWxpdHkKCk9uZSB0aGluZyByZW1haW5zIHVuY2xlYXIgZm9yIHRob3NlIHdobyBhcmUgc2tlcHRpY2FsOgpIb3cgZ29vZCBkb2VzICRcaGF0e0Z9X24kIGFwcHJveGltYXRlICRGJD8KVGVjaG5pY2FsbHkgc3BlYWtpbmcsCndoYXQgaXMgdGhlIHZhcmlhbmNlIG9mICRcaGF0e0Z9X24kPwpUaGUgZ29vZCBuZXdzIGlzLAp3ZSBkbyBoYXZlIGEgc291bmQgdGhlb3JldGljYWwgZ3JvdW5kIGRlc2NyaWJpbmcgdGhlIGJvdW5kcyBob3cgY2xvc2UgRURGIHdpbGwgYmUgdG8gQ0RGLgpUaGlzIGlzIHJlZmVycmVkIHRvIGFzIHRoZSBbRHZvcmV0emt54oCTS2llZmVy4oCTV29sZm93aXR6IGluZXF1YWxpdHldKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0R2b3JldHpreSVFMiU4MCU5M0tpZWZlciVFMiU4MCU5M1dvbGZvd2l0el9pbmVxdWFsaXR5KToKCiQkClxQclxiaWcoClxzdXBfe3ggXGluIFJ9XHZlcnQgXGhhdHtGfV9uKHgpIC0gRih4KSBcdmVydCA+IFxlcHNpbG9uClxiaWcpIFxsZXEgMmVeey0yblxlcHNpbG9uXjJ9LFxmb3JhbGxcZXBzaWxvbiA+IDAuCiQkCgpJbiBwbGFpbiB3b3JkcywKRURGIGNvbnZlcmdlcyB1bmlmb3JtbHkgdG8gQ0RGIGluICRuJCB3aXRoIGV4cG9uZW50aWFsIHNwZWVkLgpeW05vdGF0aW9uICRcc3VwJCBkZW5vdGVzIHRoZSBbc3VwcmVtdW1dKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0luZmltdW1fYW5kX3N1cHJlbXVtKToKVGhlIHNtYWxsZXN0IG51bWJlciB0aGF0IGlzIGdyZWF0ZXIgdGhhbiBvciBlcXVhbCB0byBldmVyeSBudW1iZXIgaW4gdGhlIHNldC5dCgpTbyB0aGUgaW50dWl0aW9uIG9mIHdoeSBib290c3RyYXBwaW5nIHdvcmtzIGxpZXMgaW4gdGhlIGZvbGxvd2luZyBmYWN0czoKCjEuIE1hbnkgZXN0aW1hdG9ycyBjYW4gYmUgZm9ybXVsYXRlZCBhcyBhIGxpbmVhciBmdW5jdGlvbiBvZiBDREYKMi4gRURGIGlzIGEgZ29vZCBlc3RpbWF0b3IgZm9yIENERgoKIyMgQ2FzZXMgV2hlcmUgQm9vdHN0cmFwIEZhaWxzCgpUaGVyZSBhcmUgd2VsbC1rbm93biBjYXNlcyB3aGVyZSBib290c3RyYXBwaW5nIGlzIG5vdCBhYmxlIHRvIGFwcHJveGltYXRlIHRoZSBzYW1wbGluZyBkaXN0cmlidXRpb24gb2YgdGhlIGVzdGltYXRvci4KSGVyZSBhcmUgdHdvIG9mIHRoZW06CgoxLiBNaW4gYW5kIG1heCBzdGF0aXN0aWMgKGEuay5hLiAqZW5kcG9pbnQqIGVzdGltYXRvcikKMi4gQSBwb3B1bGF0aW9uIHdpdGggaW5maW5pdGUgdmFyaWFuY2UKClRoZXkgYXJlIGJvdGggcmVsYXRlZCB0byB0aGUgYXBwbGljYWJpbGl0eSBvZiBDTFQuClRoZSBwcm9vZiBvZiB0aGUgY29udmVyZ2VuY2Ugb2YgYm9vdHN0cmFwIGRpc3RyaWJ1dGlvbiB0b3dhcmQgc2FtcGxpbmcgZGlzdHJpYnV0aW9uIGlzIGJhc2VkIG9uIENMVC4KQW55dGhpbmcgZGlzcXVhbGlmeWluZyBDTFQgd2lsbCByZXN1bHQgaW4gdGhlIGZhaWx1cmUgb2YgYm9vdHN0cmFwcGluZy4KCiMgTW9udGUgQ2FybG8gQm9vdHN0cmFwcGluZwoKSXQgaXMgcG9zc2libGUgdG8gZGVyaXZlIHRoZSBjbG9zZWQgZm9ybSBzb2x1dGlvbiBmb3IgYSBib290c3RyYXAgZGlzdHJpYnV0aW9uLgpCdXQgdGhpcyBpcyBraW5kYSBkZWZlYXRpbmcgdGhlIHB1cnBvc2Ugb2YgdXNpbmcgYm9vdHN0cmFwLgpUaGUgdmVyeSByZWFzb24gd2UgcmVzb3J0IHRvIGJvb3RzdHJhcHBpbmcgaXMgdG8gYnlwYXNzIHRoZSBuZWVkIGZvciBhIHRyYWNrYWJsZSBkZXJpdmF0aW9uLgpTbyB3ZSB3aWxsIHVzZSBbKk1vbnRlIENhcmxvKl0oaHR0cHM6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvTW9udGVfQ2FybG9fbWV0aG9kKSBzaW11bGF0aW9uIHRvIGFwcHJveGltYXRlIHRoZSBib290c3RyYXAgZGlzdHJpYnV0aW9uLgpVc3VhbGx5IHdlIGFyZSBwYXJ0aWN1bGFybHkgaW50ZXJlc3RlZCBpbiB0aGUgdmFyaWFuY2Ugb2YgdGhlIGJvb3RzdHJhcCBkaXN0cmlidXRpb24uCgpKdXN0IGEgbGl0dGxlIHJlY2FwLgpHaXZlbiBhIHBhcnRpY3VsYXIgZXN0aW1hdG9yICRcaGF0e1x0aGV0YX0oXGNkb3QpJCBhcyBhIHJhbmRvbSB2YXJpYWJsZSwKd2UgYXJlIHVzdWFsbHkgY29uY2VybmluZyBhYm91dCBpdHMgZXhwZWN0YXRpb24gYW5kIHZhcmlhbmNlLgpUaGUgZXhwZWN0YXRpb24gdGVsbHMgdXMgd2hldGhlciB0aGUgZXN0aW1hdG9yIGlzICp1bmJpYXNlZCogb3Igbm90LgpUaGUgdmFyaWFuY2UgdGVsbHMgdXMgaG93IHZvbGF0aWxlIG91ciBndWVzcyBpcywKYW5kIGFsc28gaWYgaXQgY2FuIGJlICpjb25zaXN0ZW50Ki0tY29udmVyZ2luZyB0byB0aGUgdHJ1ZSBwYXJhbWV0ZXIgb2YgaW50ZXJlc3QuCgpCeSBkZWZpbml0aW9uLAp0aGUgdmFyaWFuY2Ugb2YgYSByYW5kb20gdmFyaWFibGUgJFxoYXR7XHRoZXRhfSQgaXM6CgokJApcYmVnaW57YWxpZ25lZH0KVmFyKFxoYXR7XHRoZXRhfSkKJj0gRVxiaWdbKFxoYXR7XHRoZXRhfSAtIEUoXGhhdHtcdGhldGF9KSleMlxiaWddIFxcCiY9IEUoXGhhdHtcdGhldGF9XjIpIC0gRShcaGF0e1x0aGV0YX0pXjIuClxlbmR7YWxpZ25lZH0KJCQKCk5vdyB0byBhcHByb3hpbWF0ZSB0aGUgYWJvdmUgcmVzdWx0IHdpdGggTW9udGUgQ2FybG8gb2YgJE0kIHJlcGV0aXRpb25zLAp3ZSBjYW4gc2ltcGx5IGRvOgoKJCQKVmFyKFxoYXR7XHRoZXRhfSkgXGFwcHJveApcZnJhY3sxfXtNfVxzdW1fbSBcaGF0e1x0aGV0YX1fbV4yIC0KXGJpZ2coXGZyYWN7MX17TX1cc3VtX20gXGhhdHtcdGhldGF9X21cYmlnZyleMiAsCiQkCgp3aGVyZSBlYWNoICRcaGF0e1x0aGV0YX1fbSQgaXMgZGVyaXZlZCBmcm9tIGEgYm9vdHN0cmFwcGVkIHNhbXBsZSBhdCB0aGUgJG0kLXRoIHJlcGV0aXRpb24uCgpUaGUgYWJvdmUgYXBwcm94aW1hdGlvbiBob2xkcyB0aGFua3MgdG8gdGhlIFtMYXcgb2YgTGFyZ2UgTnVtYmVyc10oaHR0cHM6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvTGF3X29mX2xhcmdlX251bWJlcnMpIChhcyAkTSBccmlnaHRhcnJvdyBcaW5mdHkkKToKCiQkClxiZWdpbnthbGlnbmVkfQpcZnJhY3sxfXtNfVxzdW1fbSBcaGF0e1x0aGV0YX1fbQomXG92ZXJzZXR7cH1ccmlnaHRhcnJvdyBFKFxoYXR7XHRoZXRhfSksIFxcClxmcmFjezF9e019XHN1bV9tIFxoYXR7XHRoZXRhfV9tXjIKJlxvdmVyc2V0e3B9XHJpZ2h0YXJyb3cgRShcaGF0e1x0aGV0YX1eMikuClxlbmR7YWxpZ25lZH0KJCQKClJlbWVtYmVyIHRoYXQgbm93IHdlIGV4cHJlc3MgdGhlIGVzdGltYXRvciAkXGhhdHtcdGhldGF9KFgpJCBhcyBmdW5jdGlvbiBvZiBFREY6ICRcaGF0e1x0aGV0YX0oXGhhdHtGfV9uKFgpKSQsCmkuZS4sCmEgc3RhdGlzdGljYWwgZnVuY3Rpb25hbC4KTm93IHRvIGRyYXcgcmFuZG9tIHNhbXBsZSBmcm9tIHRoaXMgZnVuY3Rpb24gd2UgZG8gaS5pLmQuIHNhbXBsaW5nIHdpdGggcmVwbGFjZW1lbnQgYWdhaW5zdCAkXGhhdHtGfV9uJC4KT25jZSB0aGUgc2FtcGxlIGlzIGNvbnN0cnVjdGVkLAp3ZSBjYWxjdWxhdGUgdGhlIGNvcnJlc3BvbmRpbmcgZXN0aW1hdGUgdmFsdWUsCmFuZCB3ZSBkbyB0aGlzIGZvciBtYW55IG1hbnkgdGltZXMgdG8gZGVyaXZlIHRoZSBlbnRpcmUgZGlzdHJpYnV0aW9uIG9mIHRoZSByZXN1bHRpbmcgZXN0aW1hdGVzLgpUaGF0IGlzLAp0aGUgc2ltdWxhdGVkIGJvb3RzdHJhcCBkaXN0cmlidXRpb24uCgojIyBUaGUgRXJyb3Igb2YgTWVhc3VyaW5nIEVycm9yCgpUaGVyZSBhcmUgdHdvIHNvdXJjZXMgb2YgZXJyb3IgdGhhdCBjYW4gYXJpc2UgZnJvbSB0aGlzIGFwcHJvYWNoOgpzaW11bGF0aW9uIGVycm9yIGFuZCBlc3RpbWF0aW9uIGVycm9yLgoKU2ltdWxhdGlvbiBlcnJvciBvY2N1cnJlZCBiZWNhdXNlIHdlIGFyZSB1c2luZyBNb250ZSBDYXJsbyBmaW5pdGUgcmVwZXRpdGlvbnMuCkluY3JlYXNpbmcgdGhlIG51bWJlciBvZiByZXBldGl0aW9ucyBjYW4gZWZmZWN0aXZlbHkgZGVjcmVhc2Ugc3VjaCBlcnJvci4KVGhhbmtzIHRvIHRoZSB3aWRlLXNwcmVhZCBjb21wdXRpbmcgcG93ZXIgbm93YWRheXMsCnRoaXMgaXMgbm90IGEgYmlnIGlzc3VlIGF0IGFsbC4KCkVzdGltYXRpb24gZXJyb3IgaXMgdGhlIGVycm9yIGR1ZSB0byBzdGF0aXN0aWNhbCBub2lzZSB3aGVuIHdlIHVzZSAkXGhhdHtGfV9uJCB0byBhcHByb3hpbWF0ZSAkRiQgYW5kIGJ5IG5hdHVyZSBjYW5ub3QgYmUgZnVsbHkgZWxpbWluYXRlZCB1bmxlc3MgJG4kIGdvZXMgdG8gaW5maW5pdHkuClRvIHJlZHVjZSB0aGlzIGVycm9yIHdlIHdpbGwgbmVlZCBhIGxhcmdlciAkbiQuClJlbWVtYmVyIHRoYXQgdGhlIERLVyBpbmVxdWFsaXR5IHRlbGxzIHVzIHRoYXQgdGhlIGNvbnZlcmdlbmNlIGlzIGF0IGV4cG9uZW50aWFsIHNwZWVkIGluICRuJC4KCiMjIEhhbmRzLU9uOiBUaGUgU2FtcGxlIE1lYW4KCkxldCdzIGRlbW9uc3RyYXRlIHRoZSB1c2Ugb2YgTW9udGUgQ2FybG8gYm9vdHN0cmFwcGluZyB3aXRoIG91ciBiZXN0IGZyaWVuZCBlc3RpbWF0b3I6IHNhbXBsZSBtZWFuLgpBc3N1bWUgYSBbQmV0YSBkaXN0cmlidXRpb25dKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0JldGFfZGlzdHJpYnV0aW9uKSBhcyBvdXIgcHJldGVuZGluZ2x5IHVua25vd24gcG9wdWxhdGlvbiB3aXRoIHRoZSBQREY6CgpgYGB7ciBiZXRhX3BvcHVsYXRpb25fcGRmfQpiZXRhX2EgPC0gMgpiZXRhX2IgPC0gMTAKbXVfYmV0YSA8LSBiZXRhX2EgLyAoYmV0YV9hICsgYmV0YV9iKQp2YXJfYmV0YSA8LSAoYmV0YV9hICogYmV0YV9iKSAvICgoYmV0YV9hICsgYmV0YV9iKV4yKihiZXRhX2EgKyBiZXRhX2IgKyAxKSkKCmJldGFfcGRmIDwtIGZ1bmN0aW9uKHgpIGRiZXRhKHgsIGJldGFfYSwgYmV0YV9iKQpjdXJ2ZShiZXRhX3BkZiwgZnJvbT0wLCB0bz0xLCB5bGFiPSJEZW5zaXR5IiwKICAgICAgbWFpbj1zcHJpbnRmKCIoVW5rbm93bikgUG9wdWxhdGlvbiBCZXRhKCVzLCAlcykgUERGIiwgYmV0YV9hLCBiZXRhX2IpKQpgYGAKCmFuZCB0aGUgQ0RGOgoKYGBge3IgYmV0YV9wb3B1bGF0aW9uX2NkZn0KYmV0YV9jZGYgPC0gZnVuY3Rpb24oeCkgcGJldGEoeCwgYmV0YV9hLCBiZXRhX2IpCmN1cnZlKGJldGFfY2RmLCBmcm9tPTAsIHRvPTEsIHlsYWI9IkRlbnNpdHkiLAogICAgICBtYWluPXNwcmludGYoIihVbmtub3duKSBQb3B1bGF0aW9uIEJldGEoJXMsICVzKSBDREYiLCBiZXRhX2EsIGJldGFfYikpCmBgYAoKTm93IHdlIGRyYXcgYSByYW5kb20gc2FtcGxlIHdpdGggYSBmYWlyIHNpemUgZnJvbSB0aGUgcG9wdWxhdGlvbi4KV2UgcGxvdCB0aGUgcmVzdWx0aW5nIGhpc3RvZ3JhbSAocHJvYmFiaWxpdHkgbWFzcyBmdW5jdGlvbiwgb3IgUE1GKToKCmBgYHtyIGJldGFfc2FtcGxlX3BtZn0Kc2V0LnNlZWQoNjY2KQpuIDwtIDUwMDAKeCA8LSByYmV0YShuLCBiZXRhX2EsIGJldGFfYikKaGlzdCh4LCBtYWluPSJQcm9iYWJpbGl0eSBNYXNzIEZ1bmN0aW9uIG9mIFgiLCBwcm9iYWJpbGl0eT1UUlVFKQpgYGAKCmFuZCB0aGUgRURGOgoKYGBge3IgYmV0YV9zYW1wbGVfZWRmfQpwbG90KGVjZGYoeCksIG1haW49IkVtcGlyaWNhbCBEaXN0cmlidXRpb24gRnVuY3Rpb24gb2YgWCIsIHhsaW09YygwLCAxKSkKYGBgCgojIyMgQW5hbHl0aWNhbCBTb2x1dGlvbgoKVGhlIHZhcmlhbmNlIG9mIHNhbXBsZSBtZWFuIGlzIGFuYWx5dGljYWxseSB0cmFja2FibGUsCnNvIGluZGVlZCB3ZSBkb24ndCByZWFsbHkgbmVlZCBib290c3RyYXAgdG8gdGFja2xlIHRoaXMgcHJvYmxlbS4KQnV0IHdlIGNhbiB1c2UgaXQgdG8gdmVyaWZ5IGlmIGJvb3RzdHJhcCBjYW4gcmVzdWx0IGluIHRoZSBjb3JyZWN0IGFwcHJveGltYXRpb24gdG8gb3VyIGFuYWx5dGljYWwgc29sdXRpb24uCgpIZXJlIGlzIHRoZSBkZXJpdmF0aW9uIG9mIHRoZSB2YXJpYW5jZSBvZiBzYW1wbGUgbWVhbiwKcHJvdmlkZWQgdGhhdCB0aGUgc2FtcGxlIGlzIGkuaS5kLjoKCiQkClxiZWdpbnthbGlnbmVkfQpWYXIoXGZyYWN7MX17bn1cc3VtX2l4X2kpCiY9IFxmcmFjezF9e25eMn1WYXIoXHN1bV9peF9pKSBcXAomPSBcZnJhY3sxfXtuXjJ9XHN1bV9pVmFyKHhfaSkgJlx0ZXh0eyhkdWUgdG8gaW5kZXBlbmRlbnRseSBkaXN0cmlidXRlZCl9IFxcCiY9IFxmcmFjezF9e25eMn1cY2RvdCBuIFZhcih4KSAmXHRleHR7KGR1ZSB0byBpZGVudGljYWxseSBkaXN0cmlidXRlZCl9IFxcCiY9IFxmcmFje1Zhcih4KX17bn0uClxlbmR7YWxpZ25lZH0KJCQKCk9idmlvdXNseSB0aGUgdmFyaWFuY2UgZ29lcyB0byB6ZXJvIGFzIHNhbXBsZSBzaXplIGdvZXMgdG8gaW5maW5pdHkuCkhlbmNlIHNhbXBsZSBtZWFuIGFzIGFuIGVzdGltYXRvciBpcyAqY29uc2lzdGVudCouCgpXZSBjYW4gcmVhZGlseSBjYWxjdWxhdGUgdGhlIHN0YW5kYXJkIGVycm9yIG9mIHNhbXBsZSBtZWFuIGdpdmVuIG91ciBzYW1wbGU6CgpgYGB7ciBzYW1wbGVfbWVhbl9hbmFseXRpY2FsfQojIEFzc3VtZSBrbm93aW5nIHBvcHVsYXRpb24gcy5kLiAodGhlIGdyb3VuZCB0cnV0aCkuCnNxcnQodmFyX2JldGEgLyBuKQpgYGAKCkJ1dCByZW1lbWJlciB0aGF0IHdlIGRvbid0IGtub3cgb3VyIHBvcHVsYXRpb24gc28gdGhlcmUgaXMgbm8gd2F5IHdlIGhhdmUgYWNjZXNzIHRvIHRoZSB2YXJpYW5jZSBvZiBwb3B1bGF0aW9uICh0aGUgbnVtZXJhdG9yKS4KU28gaW5zdGVhZCB3ZSB3aWxsICphbG1vc3QgYWx3YXlzKiB1c2Ugc2FtcGxlIHZhcmlhbmNlIHRvIGFwcHJveGltYXRlIHRoZSBzb2x1dGlvbjoKCmBgYHtyIHNhbXBsZV9tZWFuX2FuYWx5dGljYWxfMn0KIyBQbHVnaW4gc2FtcGxlIHN0YW5kYXJkIGRldmlhdGlvbiBzaW5jZSBwb3B1bGF0aW9uIHMuZC4gaXMgdW5rbm93bi4Kc2QoeCkgLyBzcXJ0KG4pCmBgYAoKIyMjIE1vbnRlIENhcmxvIHdpdGggTXVsdGlwbGUgU2FtcGxlcwoKTm93IGxldCdzIHNheSB3ZSBkb24ndCBrbm93IHRoZSBhbmFseXRpY2FsIHNvbHV0aW9uLgpJZiB3ZSBjYW4gZHJhdyBtb3JlIHRoYW4ganVzdCBvbmUgc2FtcGxlIGRhdGFzZXQsCndlIGNhbiB1c2UgdGhlIHJlc3VsdGluZyBkaXN0cmlidXRpb24gdG8gbWVhc3VyZSB0aGUgZXJyb3Igb2Ygb3VyIGVzdGlpbWF0b3IuCkhlcmUgaXMgYSBjb3JyZXNwb25kaW5nIE1vbnRlIENhcmxvIHNpbXVsYXRpb24gdG8gZG8gZXhhY3RseSB0aGlzOgpeW0hlcmUgd2UgZGlkbid0IGFkanVzdCB0aGUgZGVub21pbmF0b3IgdG8gJG4tMSQgaW4gdGhlIGZvcm11bGEgd2UgdXNlZC4KdXNpbmcgZnVuY3Rpb24gYHNkYCB3aWxsIGRvIHRoYXQgYnkgZGVmYXVsdC4KVGhlb3JldGljYWxseSB0aGUgYWRqdXN0bWVudCBtYWtlIHRoZSBlc3RpbWF0aW9uIHVuYmlhc2VkLgpUaGUgZWZmZWN0IGlzIG5lZ2xpZ2libGUgdGhvdWdoIHNpbmNlIHdlIGNvbnRyb2wgdGhlIG51bWJlciBvZiByZXBldGl0aW9ucywKd2hpY2ggaXMgdXN1YWxseSBhIGJpZyBlbm91Z2ggbnVtYmVyLl0KCmBgYHtyIHNhbXBsZV9tZWFuX21jfQpNIDwtIDEwMDAwCgptY19zYW1wbGluZyA8LSBmdW5jdGlvbihNLCBuLCBwcmludD1UUlVFKSB7CiAgbWNfeGJhciA8LSByZXAoTkFfcmVhbF8sIE0pCiAgZm9yICggaSBpbiBzZXFfbGVuKE0pICkgewogICAgeG0gPC0gcmJldGEobiwgYmV0YV9hLCBiZXRhX2IpCiAgICBtY194YmFyW2ldIDwtIG1lYW4oeG0pCiAgfQogIHYgPC0gc3FydChzdW0obWNfeGJhcl4yKSAvIE0gLSAoc3VtKG1jX3hiYXIpIC8gTSleMikgICMgT3Igc2ltcGx5IHNkKG1jX3hiYXIpLgogIGlmICggcHJpbnQgKSBwcmludCh2KQogIG1jX3hiYXIKfQoKbWNfeGJhciA8LSBtY19zYW1wbGluZyhNLCBuKQpgYGAKClRoZSBzaW11bGF0ZWQgZGlzdHJpYnV0aW9uIGlzIHRoZSBzYW1wbGluZyBkaXN0cmlidXRpb24gb2Ygb3VyIGVzdGltYXRvci4KQ0xUIHRlbGxzIHVzIHRoYXQgdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBvZiBzYW1wbGUgbWVhbiBpcyBhc3ltcHRvdGljYWxseSBOb3JtYWwuCkhlcmUgd2l0aG91dCBldmVuIGtub3dpbmcgdGhhdCwKd2UgY2FuIGp1c3QgdXNlIE1vbnRlIENhcmxvIHRvIGFwcHJveGltYXRlIHRoZSBhc3ltcHRvdGljIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbi4KQnV0IHRoaXMgaXMgaHlwb3RoZXRpY2FsIG9ubHkuCkluIHJlYWxpdHkgd2UgZG9uJ3QgaGF2ZSBhY2Nlc3MgdG8gbXVsdGlwbGUgcmFuZG9tIHNhbXBsZXMgZHVlIHRvIHZhcmlvdXMgcmVzb3VyY2UgY29uc3RyYWludHMsCnNvIHRoaXMgYXBwcm9hY2ggb25seSBleGlzdHMgaW4gdGhlb3J5LgoKSGVyZSB3ZSBjYW4gcGxvdCB0aGUgc2ltdWxhdGVkIGVzdGltYXRlcy4KSXQgaXMgYSBmaW5pdGUgc2FtcGxlIGFwcHJveGltYXRpb24gdG8gdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbi4KV2UgYWxzbyBwbG90IHRoZSB0aGVvcmV0aWNhbCBsaW1pdGluZyBkaXN0cmlidXRpb24gZ2l2ZW4gYnkgQ0xUIGluIGJsdWUgY3VydmUuCgpgYGB7ciBzYW1wbGVfbWVhbl9tY19kaXN0fQp4X21jIDwtIHNlcShtaW4obWNfeGJhciksIG1heChtY194YmFyKSwgbGVuZ3RoPTEwMCkgCnlfbWMgPC0gZG5vcm0oeF9tYywgbXVfYmV0YSwgc3FydCh2YXJfYmV0YSAvIG4pKQpoaXN0KG1jX3hiYXIsIG1haW49IlNhbXBsaW5nIERpc3RyaWJ1dGlvbiAoU2FtcGxlIE1lYW4pIiwgeGxhYj0iWCIsIHByb2JhYmlsaXR5PVRSVUUpCmxpbmVzKHhfbWMsIHlfbWMsIGNvbD0iYmx1ZSIsIGx3ZD0yKQpgYGAKCk9uZSBjYW4gc2VlIGhvdyBjbG9zZWx5IHRoZSBzaW11bGF0ZWQgc2FtcGxpbmcgZGlzdHJpYnV0aW9uIGluIGhpc3RvZ3JhbSBmb2xsb3dzIHRoZSB0aGVvcmV0aWNhbCBsaW1pdGluZyBkaXN0cmlidXRpb24gaW4gYmx1ZSBjdXJ2ZS4KV2hlbiBDTFQgYXBwbGllcywKd2UgY2FuIGJ5cGFzcyB0aGUgbmVlZCB0byB1c2UgbXVsdGlwbGUgc2FtcGxlIGRhdGFzZXRzIGFuZCBpbnN0ZWFkIHVzZSBvbmx5IG9uZSB0byBtZWFzdXJlIG91ciBzdGF0aXN0aWNhbCBpbmZlcmVuY2UuCgojIyMgTW9udGUgQ2FybG8gQm9vdHN0cmFwcGluZwoKQm9vdHN0cmFwcGluZyBpcyB5ZXQgYW5vdGhlciByb3V0ZSB0byB0aGUgc2FtcGxpbmcgZGlzdHJpYnV0aW9uLgpFdmVuIHRob3VnaCB3ZSBvbmx5IGhhdmUgb25lIHNhbXBsZSBkYXRhc2V0LAphbmQgd2l0aG91dCBhcHBseWluZyBDTFQsCndlIGNhbiB1c2UgYm9vdHN0cmFwcGluZyB0byBnZW5lcmF0ZSBhcyBtYW55IHJlc2FtcGxlcyBhcyB3ZSB3YW50LgpBbmQgdGhpcyBpcyB0b3RhbGx5IGZlYXNpYmxlIGdpdmVuIGVub3VnaCBjb21wdXRpbmcgcG93ZXIuCgpUaGUgc2FtZSBNb250ZSBDYXJsbyBzZXR1cCwKYnV0IG5vdyBlYWNoIHNhbXBsZSBpcyBnZW5lcmF0ZWQgYnkgYm9vdHN0cmFwcGluZyBmcm9tIHRoZSBvbmx5IHNhbXBsZSB3ZSBoYXZlIGF0IGhhbmQ6CgpgYGB7ciBzYW1wbGVfbWVhbl9ib290fQpNIDwtIDEwMDAwCgpic19zYW1wbGluZyA8LSBmdW5jdGlvbih4LCBNLCBwcmludD1UUlVFKSB7CiAgYnNfeGJhciA8LSByZXAoTkFfcmVhbF8sIE0pCiAgZm9yICggaSBpbiBzZXFfbGVuKE0pICkgewogICAgYnMgPC0gc2FtcGxlKHgsIHNpemU9bGVuZ3RoKHgpLCByZXBsYWNlPVRSVUUpICAjIFRoZSBib290c3RyYXAuCiAgICBic194YmFyW2ldIDwtIG1lYW4oYnMpCiAgfQogIHYgPC0gc3FydChzdW0oYnNfeGJhcl4yKSAvIE0gLSAoc3VtKGJzX3hiYXIpIC8gTSleMikgICMgT3Igc2ltcGx5IHNkKGJzX3hiYXIpLgogIGlmICggcHJpbnQgKSBwcmludCh2KQogIGJzX3hiYXIKfQoKYnNfeGJhciA8LSBic19zYW1wbGluZyh4LCBNKQpgYGAKClRoZSBhcHByb3hpbWF0aW9uIGlzIGFzIGdvb2QgYXMgaWYgd2UgaHlwb3RoZXRpY2FsbHkgY3JlYXRlZCBtdWx0aXBsZSBzYW1wbGVzIGZyb20gdGhlIG9yaWdpbmFsIHBvcHVsYXRpb24gKGFzIGluIHRoZSBwcmV2aW91cyBNb250ZSBDYXJsbyBleGVyY2lzZSkuCgpCZWxvdyB3ZSBwbG90IGFsbCBib290c3RyYXBwZWQgc2FtcGxlIG1lYW5zLgpXZSBhbHNvIHBsb3QgYSBncmVlbiBjdXJ2ZSBhcyB0aGUgc2FtcGxpbmcgZGlzdHJpYnV0aW9uIGFzIGlmIHRoZSBvcmlnaW5hbCBzYW1wbGUgaXMgdGhlIHBvcHVsYXRpb24uCihUaGF0IGlzLCB0aGUgb3JpZ2luYWwgc2FtcGxlIG1lYW4gYmVjb21lcyB0aGUgInBvcHVsYXRpb24gbWVhbiIuKQoKYGBge3Igc2FtcGxlX21lYW5fYnNfZGlzdH0KeF9icyA8LSBzZXEobWluKGJzX3hiYXIpLCBtYXgoYnNfeGJhciksIGxlbmd0aD0xMDApCnlfYnMgPC0gZG5vcm0oeF9icywgbWVhbih4KSwgc3FydCh2YXJfYmV0YSAvIG4pKQpoaXN0KGJzX3hiYXIsIHByb2JhYmlsaXR5PVRSVUUsCiAgICAgbWFpbj0iRGlzdHJpYnV0aW9uIG9mIEJvb3RzdHJhcHBlZCBTYW1wbGUgTWVhbiIsCiAgICAgc3ViPXNwcmludGYoIlNhbXBsZSBTaXplID0gJWkiLCBuKSwgeGxhYj0iWCIpCmxpbmVzKHhfbWMsIHlfbWMsIGNvbD0iYmx1ZSIsIGx3ZD0yKQpsaW5lcyh4X2JzLCB5X2JzLCBjb2w9ImdyZWVuIiwgbHdkPTIpCmBgYAoKTm90aWNlIHRoYXQgd2UgYWxzbyBwbG90IHRoZSBibHVlIGN1cnZlIGFzIHRoZSBsaW1pdGluZyBkaXN0cmlidXRpb24gb2Ygc2FtcGxlIG1lYW4uCk91ciBwcmV2aW91cyBNb250ZSBDYXJsbyBleGVyY2lzZSBoYXMgYWxyZWFkeSBjb25maXJtZWQgdGhpcyBpcyB0aGUgc2FtcGxpbmcgZGlzdHJpYnV0aW9uIGJhc2VkIG9uIENMVC4KQ2xlYXJseSB0aGUgYm9vdHN0cmFwcGVkIGVzdGltYXRlcyBkb2VzIE5PVCBtYWdpY2FsbHkgYXBwcm94aW1hdGUgdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbi4KVGhlcmUgaXMgYSBiaWFzIGludHJvZHVjZWQgYnkgdGhlIG9yaWdpbmFsIHNhbXBsZSBtZWFuIHdoaWNoIGlzIHN0YXRpc3RpY2FsbHkgZGV2aWF0ZWQgZnJvbSB0aGUgdHJ1ZSBtZWFuLgpCdXQgdGhleSBkbyBzaGFyZSB0aGUgc2FtZSB2YXJpYW5jZSAoc2hhcGUpLgpBbmQgc2luY2Ugd2UgYXJlIGFza2luZyBmb3IgdGhlIHZhcmlhbmNlIG9mIG91ciBlc3RpbWF0b3IsCnN1Y2ggYmlhcyBkb2VzIG5vdCBhZmZlY3Qgb3VyIGVzdGltYXRpb24gb2YgdmFyaWFuY2UgYXQgYWxsIQoKU28gdGhlIHF1ZXN0aW9uIGlzLApjYW4gdGhlIHJlc3VsdGluZyBib290c3RyYXBwZWQgZXN0aW1hdGVzIGFwcHJveGltYXRlIHRoZSBzYW1wbGluZyBkaXN0cmlidXRpb24gaW4gYm90aCBzaGFwZSBhbmQgbG9jYXRpb24/ClRoZSBhbnN3ZXIgaXMgeWVzLApidXQgd2UgbmVlZCBhIGxhcmdlIGVub3VnaCBzYW1wbGUgc2l6ZS4KTGV0J3MgZG91YmxlIHVwIG91ciBvcmlnaW5hbCBzYW1wbGUgc2l6ZSBhbmQgcmVkbyB0aGUgZW50aXJlIGV4ZXJjaXNlOgoKYGBge3IgZG91YmxlX3NhbXBsZV9zaXplfQpuMiA8LSAxMDAwMAp4MiA8LSByYmV0YShuMiwgYmV0YV9hLCBiZXRhX2IpCgptY194YmFyMiA8LSBtY19zYW1wbGluZyhNLCBuMiwgcHJpbnQ9RkFMU0UpCmJzX3hiYXIyIDwtIGJzX3NhbXBsaW5nKHgyLCBNLCBwcmludD1GQUxTRSkKCnhfbWMyIDwtIHNlcShtaW4obWNfeGJhcjIpLCBtYXgobWNfeGJhcjIpLCBsZW5ndGg9MTAwKQp5X21jMiA8LSBkbm9ybSh4X21jMiwgbXVfYmV0YSwgc3FydCh2YXJfYmV0YSAvIG4yKSkKeF9iczIgPC0gc2VxKG1pbihic194YmFyMiksIG1heChic194YmFyMiksIGxlbmd0aD0xMDApCnlfYnMyIDwtIGRub3JtKHhfYnMyLCBtZWFuKHgyKSwgc3FydCh2YXJfYmV0YSAvIG4yKSkKaGlzdChic194YmFyMiwgcHJvYmFiaWxpdHk9VFJVRSwKICAgICBtYWluPSJEaXN0cmlidXRpb24gb2YgQm9vdHN0cmFwcGVkIFNhbXBsZSBNZWFuIiwKICAgICBzdWI9c3ByaW50ZigiU2FtcGxlIFNpemUgPSAlaSIsIG4yKSwgeGxhYj0iWCIpCmxpbmVzKHhfbWMyLCB5X21jMiwgY29sPSJibHVlIiwgbHdkPTIpCmxpbmVzKHhfYnMyLCB5X2JzMiwgY29sPSJncmVlbiIsIGx3ZD0yKQpgYGAKCk5vdyB0aGUgdHdvIGRpc3RyaWJ1dGlvbnMgYXJlIGdldHRpbmcgY2xvc2VyIHRvIGVhY2ggb3RoZXIuCldlIGFsc28gb2JzZXJ2ZSB0aGF0IHRoZSByZXF1aXJlbWVudCBvbiBzYW1wbGUgc2l6ZSBmb3IgYm9vdHN0cmFwIHRvIGFwcHJveGltYXRlIChib3RoIHNoYXBlIGFuZCBsb2NhdGlvbikgdGhlIGxpbWl0aW5nIGRpc3RyaWJ1dGlvbiBpcyBtdWNoIHN0cmljdGVyIHRoYW4gdGhhdCBmb3IgQ0xUIHRvIGJlIGFwcGxpY2FibGUuCl5bU29tZSByZXNlYXJjaGVycyByZWNvbW1lbmQgJG5eMiQgcmVwZXRpdGlvbnMgd2hlcmUgJG4kIGlzIHRoZSBvcmlnaW5hbCBzYW1wbGUgc2l6ZS4KT3IgJG5cbG4gbiQgaWYgJG5eMiQgaXMgcHJvaGliaXRpdmUuXQoKVG8gc2hvdyB0aGlzIGNsZWFybHksCndlIHJ1biBhbm90aGVyIE1vbnRlIENhcmxvIHNpbXVsYXRpb24gd2l0aCBvbmx5IHNhbXBsZSBzaXplIG9mIDEwMCwKYW5kIHdlIGNhbiBzZWUgaG93IHdlbGwgdGhlIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiBpcyBhcHByb3hpbWF0aW5nIHRoZSBsaW1pdGluZyBkaXN0cmlidXRpb24gYWxyZWFkeToKCmBgYHtyIGNsdF9zbWFsbF9zYW1wbGV9Cm4zIDwtIDEwMAp4MyA8LSByYmV0YShuMywgYmV0YV9hLCBiZXRhX2IpCm1jX3hiYXIzIDwtIG1jX3NhbXBsaW5nKE0sIG4zLCBwcmludD1GQUxTRSkKeF9tYzMgPC0gc2VxKG1pbihtY194YmFyMyksIG1heChtY194YmFyMyksIGxlbmd0aD0xMDApIAp5X21jMyA8LSBkbm9ybSh4X21jMywgbXVfYmV0YSwgc3FydCh2YXJfYmV0YSAvIG4zKSkKaGlzdChtY194YmFyMywgbWFpbj0iU2FtcGxpbmcgRGlzdHJpYnV0aW9uIChTYW1wbGUgTWVhbikiLAogICAgIHN1Yj1zcHJpbnRmKCJTYW1wbGUgU2l6ZSA9ICVpIiwgbjMpLCB4bGFiPSJYIiwgcHJvYmFiaWxpdHk9VFJVRSkKbGluZXMoeF9tYzMsIHlfbWMzLCBjb2w9ImJsdWUiLCBsd2Q9MikKYGBgCgpUaGlzIHN1Z2dlc3RzIHRoYXQgd2hlbnZlciB3ZSBkbyBoYXZlIGFuYWx5dGljYWwgc29sdXRpb24gZm9yIHRoZSBsaW1pdGluZyBkaXN0cmlidXRpb24gb2Ygb3VyIGVzdGltYXRvciBiYXNlZCBvbiB0aGUgY29ycmVzcG9uZGluZyBDTFQsCndlIHNob3VsZCBqdXN0IHVzZSB0aGF0IGZvciBvdXIgaW5mZXJlbmNlIHRhc2sgaW5zdGVhZCBvZiB0cnlpbmcgYm9vdHN0cmFwcGluZy4KXltBbnkgb2xkLXNjaG9vbCB0ZXh0Ym9va3MgbWF5IG1lbnRpb24gdGhlIHJ1bGUtb2YtdGh1bWIgc2FtcGxlIHNpemUgb2YgMzAgYXMgYSBnZW5lcmFsbHkgYWNjZXB0ZWQgbGFyZ2UgZW5vdWdoIG51bWJlci4KVGhpcyBpcyBvdmVyLXNpbXBsaWZpY2F0aW9uIGFuZCBjYW4gYmUgZGFuZ2Vyb3VzIGluIHByYWN0aWNlLgpXaGV0aGVyIGEgc2FtcGxlIHNpemUgaXMgYmlnIGVub3VnaCBmb3IgQ0xUIHRvIGhhdmUgZ29vZCBhcHByb3hpbWF0aW9uIHJlYWxseSBkZXBlbmRzIG9uIHRoZSBuYXR1cmUgb2YgdGhlIHBvcHVsYXRpb24gZGlzdHJpYnV0aW9uLAp3aGljaCB1bmZvcnR1bmF0ZWx5IGlzIHVua25vd24gaW4gdGhlIGZpcnN0IHBsYWNlLgpUaGVyZSBhcmUgc29tZSBoZXVyaXN0aWNzLCB0aG91Z2guCkZvciBleGFtcGxlIHRoZSBtb3JlIHN5bW1ldHJpYyB0aGUgcG9wdWxhdGlvbiB0aGUgbGVzcyBzYW1wbGUgc2l6ZSByZXF1aXJlZCB0byBoYXZlIGEgZ29vZCBhcHByb3hpbWF0aW9uLl0KClNvLCB5ZXMsIGZvciBhIGNsYXNzaWNhbCBzdGF0aXN0aWMgbGlrZSBzYW1wbGUgbWVhbiwKdGhlcmUgaXMgbm90IG11Y2ggdmFsdWUgYWRkZWQgdXNpbmcgYm9vdHN0cmFwLgpCdXQgaXQgY2FuIGFsd2F5cyBzZXJ2ZSBhcyBhIGdvb2QgZWR1Y2F0aW9uYWwgY2FzZSBzdHVkeS4KCiMjIyMgU2Vjb25kLU9yZGVyIENvcnJlY3Rpb24gey19CgpJbiBvdXIgYWJvdmUgY29tcGFyaXNvbiBiZXR3ZWVuIGJvb3RzdHJhcCBkaXN0cmlidXRpb24gYW5kIHNhbXBsaW5nIGRpc3RyaWJ1dGlvbiwKd2hhdCB3ZSBhY3R1YWxseSBwbG90dGVkIGlzICRcaGF0e1x0aGV0YX0kIHYucy4gJFxoYXR7XHRoZXRhfV9iJC4KQnV0IHRoZSBhcHByb3hpbWF0aW9uIGlzIGJldHRlciBmb3IgJChcaGF0e1x0aGV0YX1fYiAtIFxoYXR7XHRoZXRhfSkkIHYucy4gJChcaGF0e1x0aGV0YX0gLSBcdGhldGEpJCwKYW5kIGV2ZW4gYmV0dGVyIGZvciAkXGZyYWN7KFxoYXR7XHRoZXRhfV9iIC0gXGhhdHtcdGhldGF9KX17c2VfYn0kIHYucy4gJFxmcmFjeyhcaGF0e1x0aGV0YX0gLSBcdGhldGEpfXtzZX0kLgpUaGUgbGFzdCBvbmUgaXMgcmVmZXJyZWQgdG8gYXMgKnNlY29uZC1vcmRlciBjb3JyZWN0aW9uKiBvZiBib290c3RyYXAgaW4gdGhlIGxpdGVyYXR1cmUuCgpGb3Igb3VyIHByZXZpb3VzIGV4YW1wbGUgaWYgd2UgcGxvdCBpbnN0ZWFkIHRoZSBkZS1tZWFuZWQgdmVyc2lvbjoKCmBgYHtyIGJzX2NvbnZlcmdlbmNlfQojIFBsb3Qgc21vb3RoIGRlbnNpdHkgaW5zdGVhZCBvZiBoaXN0b2dyYW0gdG8gbWFrZSBpdCBlYXNpZXIgdG8gc2VlIHRoZSBvdmVybGFwcGluZy4KcGxvdChkZW5zaXR5KGJzX3hiYXIgLSBtZWFuKHgpKSwgY29sPSJncmVlbiIsCiAgICAgbWFpbj0iTW9udGUgQ2FybG8gU2FtcGxpbmcgRGlzdHJpYnV0aW9uIHYucy4gQm9vdHN0cmFwIERpc3RyaWJ1dGlvbiIsCiAgICAgc3ViPXNwcmludGYoIlNhbXBsZSBTaXplID0gJWkiLCBuKSwKICAgICB4bGFiPSJYIChEZS1NZWFuZWQpIikKbGluZXMoZGVuc2l0eShtY194YmFyIC0gbXVfYmV0YSksIGNvbD0iYmx1ZSIpCmxlZ2VuZCgidG9wcmlnaHQiLAogICAgICAgYyhleHByZXNzaW9uKGhhdCh0aGV0YSlbYl0gLSBoYXQodGhldGEpKSwKICAgICAgICAgZXhwcmVzc2lvbihoYXQodGhldGEpIC0gdGhldGEpKSwKICAgICAgIGNvbD1jKCJncmVlbiIsICJibHVlIiksIHBjaD1jKDEsIDEpKQpgYGAKCldlIHNlZSB0aGF0IHRoZSBjb252ZXJnZW5jZSBpcyBpbmRlZWQgcXVpdGUgZ29vZCBhbHJlYWR5LgoKIyMjIFVzaW5nIFBhY2thZ2UgYGJvb3RgCgpSYXRoZXIgdGhhbiBpbXBsZW1lbnRpbmcgdGhlIHNhbXBsaW5nIHByb2NlZHVyZSBmcm9tIHNjcmF0Y2gsCndlIGNhbiBhbHNvIHRha2UgYWR2YW50YWdlIG9mIHRoZSBidWlsdC1pbiBwYWNrYWdlIGBib290YCBbQGJvb3RdIGluIFIgdG8gc2ltcGxpZnkgb3VyIGNvZGU6CgpgYGB7ciBpbXBvcnRfYm9vdCwgcmVzdWx0cz0iaGlkZSIsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CmxpYnJhcnkoYm9vdCkgICMgVGhpcyBpcyBhIGJ1aWx0LWluIHBhY2thZ2UuCmBgYAoKCmBgYHtyIHNhbXBsZV9tZWFuX2Jvb3RfMn0KYnNfciA8LSBib290KHgsIGZ1bmN0aW9uKHgsIGkpIG1lYW4oeFtpXSksIFI9TSwgcGFyYWxsZWw9Im11bHRpY29yZSIpCnByaW50KGJzX3IpCmBgYAoKVGhlIGJpYXMgcmVwb3J0ZWQgYnkgYGJvb3RgIGlzIHNpbXBseSB0aGUgZGlmZmVyZW5jZSBiZXR3ZWVuIHRoZSBhdmVyYWdlIG9mIG91ciBzaW11bGF0ZWQgZXN0aW1hdGVzIGFuZCB0aGUgb3JpZ2luYWwgZXN0aW1hdGU6CgpgYGB7ciB2ZXJpZnlfYmlhc30KbWVhbihic19yJHQpIC0gbWVhbih4KQpgYGAKCkl0IHNob3VsZCBiZSB2ZXJ5IGNsb3NlIHRvIHplcm8gaWYgbm90aGluZyB3ZW50IHdyb25nLgoKVGhlIHJldHVybmVkIG9iamVjdCBmcm9tIGBib290YCBhbHNvIGhhcyBhIGNvbnZlbmllbnQgYHBsb3RgIG1ldGhvZCBmb3IgdmlzdWFsaXphdGlvbiBwdXJwb3NlOgoKYGBge3IgYm9vdF9wbG90LCBmaWcud2lkdGg9OH0KcGxvdChic19yKQpgYGAKCldlIGNhbiBhbHNvIHVzZSB0aGUgZnVuY3Rpb24gYGJvb3QuYXJyYXlgIHRvIGNoZWNrIGhvdyBtYW55IHRpbWVzIGEgZGF0YSBwb2ludCBpcyByZXNhbXBsZWQgYXQgZWFjaCByZXBldGl0aW9uLgpGb3IgZXhhbXBsZSB0byBjaGVjayBob3cgbWFueSB0aW1lcyB0aGUgZmlzcnQgdHdvIGV4YW1wbGVzIGFyZSByZXNhbXBsZWQgYXQgdGhlIGZpcnN0IDEwIHJlcGV0aXRpb25zOgoKYGBge3IgYm9vdC5hcnJheX0KYm9vdC5hcnJheShic19yKVsxOjEwLDE6Ml0KYGBgCgpUaGUgcm93IGRpbWVuc2lvbiBpcyByZXBldGl0aW9uIGFuZCB0aGUgY29sdW1uIGRpbWVuc2lvbiBpcyBkYXRhLgoKIyMjIENvbmZpZGVuY2UgSW50ZXJ2YWwKClNpbmNlIHdlIG5vdyBoYXZlIGFjY2VzcyB0byBhbGwgc2ltdWxhdGVkIGVzdGltYXRlcywKd2UgY2FuIGVhc2lseSBjb25zdHJ1Y3QgdGhlIGNvbmZpZGVuY2UgaW50ZXJ2YWwgYXMgd2VsbDoKCmBgYHtyIHNhbXBsZV9tZWFuX2Jvb3RfY2l9CnF1YW50aWxlKGJzX3IkdCwgcHJvYnM9YyguMDI1LCAuOTc1KSkKYGBgCgpPZiBjb3Vyc2UgZm9yIHNpbXBsZSBlc3RpbWF0b3Igc3VjaCBhcyBzYW1wbGUgbWVhbiwKd2UgZG8gaGF2ZSB0aGUgYW5hbHl0aWNhbCBzb2x1dGlvbiBmb3IgaXRzIGNvbmZpZGVuY2UgaW50ZXJ2YWwuCkJ1dCBib290c3RyYXBwaW5nIGlzIGFibGUgdG8gZG8gdGhlIGFwcHJveGltYXRpb24gd2l0aG91dCBrbm93aW5nIHRoZSBzb2x1dGlvbi4KCiMjIyBNZWFuIFNxdWFyZWQgRXJyb3IKCkFub3RoZXIgcG9zc2libGUgKHRob3VnaCBoaWdseSBzaW1pbGFyIHRvIHZhcmlhbmNlKSBtZXRyaWMgd2UgbWF5IHdhbnQgdG8gbG9vayBhdCBpcyB0aGUgbWVhbiBzcXVhcmVkIGVycm9yIChNU0UpLgpXZSBjYW4gYXBwcm94aW1hdGUgTVNFIG9mIG91ciBlc3RpbWF0b3IgdXNpbmcgYm9vdHN0cmFwcGluZzoKCiQkClx0ZXh0e01TRX0oXGhhdHtcdGhldGF9KSA9IFxmcmFjezF9e019XHN1bV9tKFxoYXR7XHRoZXRhfV9tIC0gXGhhdHtcdGhldGF9KV4yLgokJAoKU28gZm9yIHRoZSBzYW1wbGUgbWVhbiBleGFtcGxlLAp3ZSBjYW4gZG86CgpgYGB7ciBzYW1wbGVfbWVhbl9tc2V9CiMgV2UgdXNlIHJvb3QgbWVhbiBzcXVhcmVkIGVycm9yIGluc3RlYWQgc2luY2UgdGhlIG51bWJlciBpcyBzbWFsbC4Kc3FydChtZWFuKChic19yJHQgLSBtZWFuKHgpKV4yKSkKYGBgCgojIyBIYW5kcy1PbjogVC1TdGF0aXN0aWMKClRoZSBbdC1zdGF0aXN0aWNdKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL1Qtc3RhdGlzdGljKSBpczoKCiQkCnQgPSBcZnJhY3tcYmFye1h9IC0gXG11fXtzIC8gXHNxcnR7bn19LAokJAoKd2hlcmUgJHMkIGlzIHRoZSBzdGFuZGFyZCBkZXZpYXRpb24gb2Ygc2FtcGxlICRYJC4KClRoZSAodHdvLXNpZGVkKSBjb25maWRlbmNlIGludGVydmFsIGZvciAkXG11JCBpczoKCiQkClxiYXJ7WH1ccG0gdF97KDEgLSBcYWxwaGEvMil9IFx0aW1lcyBcZnJhY3tzfXtcc3FydHtufX0sCiQkCgp3aGVyZSAkdF97KDEgLSBcYWxwaGEvMil9JCBpcyB0aGUgdC1zdGF0aXN0aWMgYXQgY29uZmlkZW5jZSBsZXZlbCAkXGFscGhhJCB3aXRoIGRlZ3JlZSBvZiBmcmVlZG9tICRuIC0gMSQuCgpGb3Igb3VyIGRlbW8gZXhhbXBsZSB0aGUgZ3JvdWQgdHJ1dGggb2YgdC1zdGF0aXN0aWMgaXM6CgpgYGB7ciB0X3N0YXRfdHJ1ZX0KKG1lYW4oeCkgLSBtdV9iZXRhKSAvIChzZCh4KSAvIHNxcnQobikpICAjIFQtc3RhdC4KYGBgCgpPciB3ZSBjYW4gdXNlIHRoZSBidWlsdC1pbiB0ZXN0IGZ1bmN0aW9uIHRvIGFsc28gY29tcHV0ZSB0aGUgY29uZmlkZW5jZSBpbnRlcnZhbCBjb252ZW5pZW50bHk6CgpgYGB7ciB0X3N0YXRfY2l9CnQudGVzdCh4LCBtdT1tdV9iZXRhKQpgYGAKCk5vdGUgdGhhdCB0aGUgYWJvdmUgaW50ZXJ2YWwgaXMgbm90IGRlcml2ZWQgYnkgcGx1Z2luZyB0aGUgdW5rbm93biBwYXJhbWV0ZXIgJFxtdSQsCmJ1dCBiYXNlZCBvbiB0aGUgbGltaXRpbmcgZGlzdHJpYnV0aW9uIG9mIHQtc3RhdGlzdGljLAp0aGUgW1N0dWRlbnQncyB0LWRpc3RyaWJ1dGlvbl0oaHR0cHM6Ly9lbi53aWtpcGVkaWEub3JnL3dpa2kvU3R1ZGVudCUyN3NfdC1kaXN0cmlidXRpb24pLgpUbyB2ZXJpZnkgdGhpczoKCmBgYHtyIHZlcmlmeV9jaX0KIyBVc2UgcXQgdG8gbG9vayB1cCB0aGUgdmFsdWUuCm1lYW4oeCkgKyBxdChjKC4wMjUsIC45NzUpLCBkZj1uIC0gMSkgKiAoc2QoeCkgLyBzcXJ0KG4pKQpgYGAKCkluc3RlYWQgd2UgY2FuIHVzZSB0aGUgYm9vdHN0cmFwcGVkIHQtc3RhdGlzdGljIHRvIGFwcHJveGltYXRlIHRoZSB1bmtub3duIHRydWUgdC1zdGF0aXN0aWM6CgokJAp0X2IgPSBcZnJhY3tcYmFye1h9X2IgLSBcYmFye1h9fXtzX2IgLyBcc3FydHtufX0uCiQkCgpUaGVuIGFsbCB3ZSBuZWVkIHRvIGRvIGlzIHRvIHJlcGxhY2UgJHQkIHdpdGggJHRfYiQgaW4gdGhlIGVxdWF0aW9uOgoKJCQKXGJhcntYfVxwbSB0X3tieygxIC0gXGFscGhhLzIpfX0gXHRpbWVzIFxmcmFje3N9e1xzcXJ0e259fS4KJCQKClRoZSBleGFjdCBleGVyY2lzZSBmb2xsb3dzLgoKYGBge3IgdF9zdGF0X2JzfQojIFJlLWRlZmluZSB0aGUgYm9vdHN0cmFwcGVyIHNpbmNlIHRoaXMgdGltZSB3ZSBuZWVkIGFjY2VzcyB0byBzZCh4X2IpIGFzIHdlbGwuCnRfYnNfc2FtcGxpbmcgPC0gZnVuY3Rpb24oeCwgTSkgewogIGJzX3hiYXIgPC0gcmVwKE5BX3JlYWxfLCBNKQogIGJzX3NkIDwtIHJlcChOQV9yZWFsXywgTSkKICBmb3IgKCBpIGluIHNlcV9sZW4oTSkgKSB7CiAgICBicyA8LSBzYW1wbGUoeCwgc2l6ZT1sZW5ndGgoeCksIHJlcGxhY2U9VFJVRSkgICMgVGhlIGJvb3RzdHJhcC4KICAgIGJzX3hiYXJbaV0gPC0gbWVhbihicykKICAgIGJzX3NkW2ldIDwtIHNkKGJzKSAgIyBDb21wdXRlIGFsc28gc3RhbmRhcmQgZGVpdmlhdGlvbiBmb3IgZWFjaCByZXNhbXBsZS4KICB9CiAgbGlzdCh4YmFyPWJzX3hiYXIsIHNkPWJzX3NkKQp9CgpyZXMgPC0gdF9ic19zYW1wbGluZyh4LCBNKQpic190IDwtIChyZXMkeGJhciAtIG1lYW4oeCkpIC8gKHJlcyRzZC9zcXJ0KG4pKSAgIyBCb290c3RyYXAgdC1zdGF0aXN0aWNzLgoKIyBCb290c3RyYXBwZWQgY29uZmlkZW5jZSBpbnRlcnZhbCBvZiBtdSB1c2luZyB0LXN0YXRpc3RpYy4KbWVhbih4KSArIChzZCh4KSAvIHNxcnQobikpICogcXVhbnRpbGUoYnNfdCwgYyguMDI1LCAuOTc1KSkKYGBgCgpXaGF0IHdlIGRlbW9uc2F0cmF0ZSBoZXJlIGlzIHRoYXQgdGhlIGJvb3RzdHJhcCBkaXN0cmlidXRpb24gb2YgdC1zdGF0aXN0aWMgaXMgYWxzbyBjb252ZXJnaW5nIHRvIHRoZSBzYW1wbGluZyBkaXN0cmlidXRpb24gb2YgdC1zdGF0aXN0aWMuCgojIEJvb3RzdHJhcHBpbmcgZm9yIFJlZ3Jlc3Npb24gTW9kZWxzCgpOb3cgd2UgdW5kZXJzdGFuZCB0aGUgYmFzaWMgaWRlYSBvZiBib290c3RyYXBwaW5nLgpJbiB0aGlzIHNlY3Rpb24gd2UgZnVydGhlciBkaXNjdXNzIGl0cyBhcHBsaWNhdGlvbiBmb3IgYSBsaW5lYXIgcmVncmVzc2lvbiBtb2RlbC4KCldlIGNyZWF0ZSBzb21lIHNpbXVsYXRlZCBkYXRhIHdpdGggYSBoeXBvdGVodGljYWwgdHJ1ZSBtb2RlbDoKCmBgYHtyIGxtX3NpbV9kYXRhfQpzZXQuc2VlZCg3NzcpCnNpemUgPC0gMTAwMDAKbnVtX2ZlYXR1cmUgPC0gMgoKIyBSZWdyZXNzb3JzIChkZXNpZ24gbWF0cml4KS4KWCA8LSByYmV0YShzaXplICogKG51bV9mZWF0dXJlICsgMSksIGJldGFfYSwgYmV0YV9iKQpYIDwtIGNiaW5kKDEsIG1hdHJpeChYLCBuY29sPW51bV9mZWF0dXJlICsgMSkpCmNvbG5hbWVzKFgpIDwtIHBhc3RlMCgieF8iLCAwOjMpCgojIE5vaXNlLgplIDwtIHJub3JtKHNpemUpCgojIFRydWUgcGFyYW1ldGVycy4KdHJ1ZV9jb2VmcyA8LSBydW5pZihudW1fZmVhdHVyZSArIDIpCm5hbWVzKHRydWVfY29lZnMpIDwtIGNvbG5hbWVzKFgpCgojIFJlc3BvbnNlLgp5IDwtIChYICUqJSB0cnVlX2NvZWZzICsgZSkKCiMgV2Ugd2lsbCBwdXJwb3NlbHkgb21pdCBvbmUgY292YXJpYXRlIHRvIG1ha2UgdGhlIGRhdGEgYSBsaXR0bGUgYml0ICJyZWFsIi4KWHkgPC0gYXMuZGF0YS5mcmFtZShYWywxOihudW1fZmVhdHVyZSArIDEpXSkKWHkkeSA8LSB5CgpoZWFkKFh5KQpgYGAKClRoZSB0cnVlIHBhcmFtZXRlcnMgYXJlOgoKYGBge3IgbG1fc2ltX3RydWVfcGFyYW1zfQpwcmludCh0cnVlX2NvZWZzKQpgYGAKClRoZSBsYXN0IHBhcmFtZXRlciB3aWxsIGJlIG9taXR0ZWQgaW4gb3VyIG1vZGVsIGZpdCBzaW5jZSB3ZSBwcmV0ZW5kIGFzIGlmIGl0IGlzIG5vdCBvYnNlcnZhYmxlLgoKV2UgZml0IHRoZSBtb2RlbCBhbmQgcmVwb3J0IHRoZSBbaGV0ZXJvc2tlZGFzdGljaXR5IGNvbnNpc3RlbnQgc3RhbmRhcmQgZXJyb3JdKGh0dHBzOi8vZW4ud2lraXBlZGlhLm9yZy93aWtpL0hldGVyb3NjZWRhc3RpY2l0eS1jb25zaXN0ZW50X3N0YW5kYXJkX2Vycm9ycyk6Cl5bRXZlbiB0aG91Z2ggd2Uga25vdyB0aGF0IG91ciB0cnVlIG1vZGVsIGhhcyBob21vc2tlZGFzdGljIGVycm9yLAp0aGUgSEMgYXBwcm9hY2ggaXMgbW9yZSByb2J1c3QgaW4gcHJhY3RpY2UuXQoKYGBge3IgaW1wb3J0X2hjLCByZXN1bHRzPSJoaWRlIiwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KbGlicmFyeShsbXRlc3QpCmxpYnJhcnkoc2FuZHdpY2gpCmBgYAoKYGBge3IgbG1fc2ltX3Jlc30KbG1fbW9kZWwgPC0gbG0oeSB+IC4gLSAxLCBkYXRhPVh5KQpjb2VmdGVzdChsbV9tb2RlbCwgdmNvdj12Y292SEMobG1fbW9kZWwsIHR5cGU9IkhDMCIpKQpgYGAKCiMjIENhc2UtV2lzZSBCb290c3RyYXAKClRoZSBzaW1wbGllc3QgYXBwcm9hY2ggaXMgdG8gcmVzYW1wbGUgYXQgdGhlIG9ic2VydmF0aW9uIGxldmVsLgpUbyBzcGVlZCB1cCB0aGUgcmVwZXRpdGlvbnMgd2Ugd2lsbCBkaXJlY3RseSBjb21wdXRlIHRoZSBhbmFseXRpY2FsIHNvbHV0aW9uIHJhdGhlciB0aGFuIGNhbGxpbmcgYGxtYCB0byBhdm9pZCB0aGUgb3ZlcmhlYWQuCkhlcmUgaXMgYSBxdWljayBzaW5nbGUtdGhyZWFkZWQgaW1wbGVtZW50YXRpb24gZnJvbSBzY3JhdGNoOgoKYGBgcgpvbHMgPC0gZnVuY3Rpb24oWCwgeSkgewogICMgQW5hbHl0aWNhbCBzb2x1dGlvbiBmb3IgT0xTIGVzdGltYXRvci4KICBzb2x2ZSh0KFgpICUqJSBYKSAlKiUgdChYKSAlKiUgeQp9Cgpic19jb2VmcyA8LSBtYXRyaXgoTkFfcmVhbF8sIG5yb3c9MSArIG51bV9mZWF0dXJlLCBuY29sPU0pCmZvciAoIGkgaW4gc2VxX2xlbihNKSApIHsKICBYeV9iIDwtIGFzLm1hdHJpeChYeVtzYW1wbGUoc2l6ZSwgcmVwbGFjZT1UUlVFKSxdKQogIGNvZWZzX2IgPC0gb2xzKFg9WHlfYlssIDA6bnVtX2ZlYXR1cmUgKyAxXSwgeT1YeV9iWywgbmNvbChYeV9iKV0pCiAgYnNfY29lZnNbLGldIDwtIGNvZWZzX2IKfQpgYGAKCkluc3RlYWQgbGV0J3MgdGFrZSBhZHZhbnRhZ2Ugb2YgYGJvb3RgIHRvIHNpbXBsaWZ5IGFuZCBhbHNvIHNwZWVkIHVwIG91ciBjb2RlOgoKYGBge3IgYm9vdF9sbV9jYXNld2lzZX0KcmVnIDwtIGZ1bmN0aW9uKFh5LCBpKSB7CiAgWHkgPC0gWHlbaSxdCiAgWCA8LSBYeVssIDA6bnVtX2ZlYXR1cmUgKyAxXQogIHkgPC0gWHlbLCBuY29sKFh5KV0KICBzb2x2ZSh0KFgpICUqJSBYKSAlKiUgdChYKSAlKiUgeQp9Cgpic19jb2VmcyA8LSBib290KGFzLm1hdHJpeChYeSksIHJlZywgUj1NLCBwYXJhbGxlbD0ibXVsdGljb3JlIikKcHJpbnQoYnNfY29lZnMpCmBgYAoKVG8gcGxvdCB0aGUgYm9vdHN0cmFwIGRpc3RyaWJ1dGlvbiBvZiB0aGUgM3JkIGNvZWZmaWNpZW50OgoKYGBge3IgYm9vdF9sbV9wbG90LCBmaWcud2lkdGg9OH0KcGxvdChic19jb2VmcywgaW5kZXg9MykKYGBgCgpDYXNlLXdpc2UgYm9vdHN0cmFwcGluZyBpbXBsaWNpdGx5IGFzc3VtZXMgY292YXJpYXRlcyBhcmUgcmFuZG9tbHkgYXNzaWduZWQsCndoaWNoIG1heSBub3QgYmUganVzdGlmaWFibGUgaWYgd2UgYmVsaWV2ZSBvdXIgZGF0YSBpcyBjb2xsZWN0ZWQgaW4gYSBoaWdobHkgY29udHJvbGxlZCBtYW5uZXIuCkZvciBleGFtcGxlLApkYXRhIG1heSBiZSBjb2xsZWN0ZWQgZnJvbSBhbiBleHBlcmltZW50YWwgZGVzaWduIChzbyBzb21lIG9mIHRoZSBmZWF0dXJlcyBhcmUgZGlyZWN0bHkgc2V0IGJ5IHRoZSByZXNlYXJjaGVyKS4KSW4gc3VjaCBzY2VuYXJpbyB3ZSBjYW4gcmVzb3J0IHRvIGFub3RoZXIgYXBwcm9hY2g6CmJvb3RzdHJhcHBpbmcgdGhlIG1vZGVsIHJlc2lkdWFscy4KCiMjIFJlc2lkdWFsIEJvb3RzdHJhcAoKSWYgd2UnZCBsaWtlIHRvIGhvbGQgb3VyIGRlc2lnbiBtYXRyaXggZml4ZWQsCndlIGNhbiByZXNhbXBsZSBpbnN0ZWFkIHRoZSByZXNpZHVhbHMgZnJvbSB0aGUgZml0dGVkIG1vZGVsLgpCZSBhd2FyZSB0aGF0IHRoaXMgaW1wbGljaXRseSBhc3N1bWVzIHRoYXQgdGhlIGVycm9yIHRlcm0gaXMgaWRlbnRpY2FsbHkgZGlzdHJpYnV0ZWQuCgpBbnl3YXkgbGV0J3MgZG8gdGhlIGV4ZXJjaXNlLgpIZXJlIGlzIGFnYWluIHRoZSBzaW5nbGUtdGhyZWFkZWQgaW1wbGVtZW50YXRpb24gZnJvbSBzY3JhdGNoOgoKYGBgcgpic19jb2VmczIgPC0gbWF0cml4KE5BX3JlYWxfLCBucm93PTEgKyBudW1fZmVhdHVyZSwgbmNvbD1NKQp5aGF0IDwtIHByZWRpY3QobG1fbW9kZWwsIFh5KQpmb3IgKCBpIGluIHNlcV9sZW4oTSkgKSB7CiAgZV9iIDwtIHNhbXBsZShsbV9tb2RlbCRyZXNpZHVhbHMsIHNpemU9c2l6ZSwgcmVwbGFjZT1UUlVFKSAgIyBSZXNpZHVhbCBib290c3RyYXBwaW5nLgogIHlfYiA8LSB5aGF0ICsgZV9iCiAgYnNfY29lZnMyWyxpXSA8LSBvbHMoWD1YWywgMDpudW1fZmVhdHVyZSArIDFdLCB5PXlfYikKfQpgYGAKCkFuZCB3aXRoIGBib290YDoKCmBgYHtyIGJvb3RfbG1fcmVzaWR9ClhfIDwtIFhbLCAwOm51bV9mZWF0dXJlICsgMV0gICMgRGVzaWduIG1hdHJpeCBpcyBmaXhlZC4KeWhhdCA8LSBwcmVkaWN0KGxtX21vZGVsLCBYeSkKCnJlZzIgPC0gZnVuY3Rpb24oZSwgaSkgewogIHkgPC0geWhhdCArIGVbaV0KICBzb2x2ZSh0KFhfKSAlKiUgWF8pICUqJSB0KFhfKSAlKiUgeQp9Cgpic19jb2VmczIgPC0gYm9vdChsbV9tb2RlbCRyZXNpZHVhbHMsIHJlZzIsIFI9TSwgcGFyYWxsZWw9Im11bHRpY29yZSIpCnByaW50KGJzX2NvZWZzMikKYGBgCgpBcyBvbmUgY2FuIHNlZSBpbiBvdXIgdG95IGV4YW1wbGUgdGhlIHR3byBhcHByb2FjaGVzIGRvbid0IGhhdmUgdG9vIG11Y2ggZGlzY3JlcGFuY3kuCgpTaW5jZSByZXNpZHVhbCBib29zdHJhcHBpbmcgcmVsaWVzIG9uIHRoZSBmaXR0ZWQgcmVzaWR1YWxzLAp0aGUgb3JpZ2luYWwgbW9kZWwgc3BlY2lmaWNhdGlvbiBtdXN0IGJlIG1lYW5pbmdmdWwgaW4gdGhlIGZpcnN0IHBsYWNlLgoKIyMgQm9vdHN0cmFwcGluZyBmb3IgVGltZSBTZXJpZXMKClRpbWUgc2VyaWVzIGFyZSB1c3VhbGx5IGF1dG9jb3JyZWxhdGVkLgpUaGlzIG1lYW5zIHRoYXQgZWl0aGVyIGNhc2Utd2lzZSBvciByZXNpZHVhbCBib290c3RyYXBwaW5nIHdvbid0IHdvcmsgYmVjYXVzZSB0aGUgdW5kZXJseWluZyBhc3N1bXB0aW9ucyBhcmUgaGVhdmlseSB2aW9sYXRlZC4KVG8gZGVhbCB3aXRoIGF1dG9jb3JyZWxhdGlvbiBhIHZhcmlldHkgb2YgWypibG9jayogYm9vdHN0cmFwXShodHRwczovL2VuLndpa2lwZWRpYS5vcmcvd2lraS9Cb290c3RyYXBwaW5nXyhzdGF0aXN0aWNzKSNCbG9ja19ib290c3RyYXApIG1ldGhvZHMgaGF2ZSBiZWVuIHByb3Bvc2VkLgpUaGUgZ2VuZXJhbCBpZGVhIGlzIHRvIHJlc2FtcGxlIGF0IGJsb2NrLWxldmVsIGluc3RlYWQgb2YgaW5kaXZpZHVhbCBsZXZlbCB0byBtYWludGFpbiB0aGUgdW5kZXJseWluZyBhdXRvY29ycmVsYXRpb24gc3RydWN0dXJlLgpXZSB3aWxsIHNraXAgdGhlIGRldGFpbGVkIGRpc2N1c3Npb24gaGVyZSB0byBrZWVwIHRoZSBzY29wZSBzbWFsbC4KXltCbG9jayBib290c3RyYXAgaXMgbm90IGxpbWl0ZWQgdG8gdGltZSBzZXJpZXMuCkl0IGNhbiBhbHNvIGFwcGx5IHRvIGRhdGEgd2l0aCBzcGF0aWFsIGNvcnJlbGF0aW9uLl0KCiMgUmVmZXJlbmNlcwo=