This is a simplified version of the program used for the Kaggle competition https://www.kaggle.com/dkyleward/xgboost-using-mlr-package-r/data


The purpose of this report is to show the (relative) simplicity of implementing xgboost with the MLR package in R. MLR supports a wide range of learning algorithms, which can be switched out easily, too.

For much more information on the MLR package, see the tutorial here: https://mlr-org.github.io/mlr-tutorial/release/html/index.html

library(tidyverse) # data manipulation
library(mlr)       # ML package (also some data manipulation)
library(knitr)     # just using this for kable() to make pretty tables
library(xgboost)
# The 'xgboost' library must be installed - doesn't need to be loaded
train_orig <- read_csv("xgboost_train.csv")
test_orig <- read_csv("xgboost_test.csv")

1 Data preparation

1.1 Data cleaning

First, I combine the train and test data together so that cleaning only needs to be done once and any averages (or other stats) are more accurate. Creating a new column to mark each data set allows me to easily separate them again after cleaning.

train <- train_orig %>%
  mutate(dataset = "train")

test <- test_orig %>%
  mutate(dataset = "test")

combined <- bind_rows(train, test)

MLR is a library for machine learning, and it contains many useful tools for data science in general. For example, the summarizeColumns() function is great for getting a quick overview of the data.

summarizeColumns(combined) %>%
  kable(digits = 2)
name type na mean disp median mad min max nlevs
PassengerId integer 0 655.00 378.02 655.00 484.81 1.00 1309.00 0
Survived integer 418 0.38 0.49 0.00 0.00 0.00 1.00 0
Pclass integer 0 2.29 0.84 3.00 0.00 1.00 3.00 0
Name character 0 NA 1.00 NA NA 1.00 2.00 1307
Sex character 0 NA 0.36 NA NA 466.00 843.00 2
Age numeric 263 29.88 14.41 28.00 11.86 0.17 80.00 0
SibSp integer 0 0.50 1.04 0.00 0.00 0.00 8.00 0
Parch integer 0 0.39 0.87 0.00 0.00 0.00 9.00 0
Ticket character 0 NA 0.99 NA NA 1.00 11.00 929
Fare numeric 1 33.30 51.76 14.45 10.24 0.00 512.33 0
Cabin character 1014 NA NA NA NA 1.00 6.00 186
Embarked character 2 NA NA NA NA 123.00 914.00 3
dataset character 0 NA 0.32 NA NA 418.00 891.00 2

1.2 Dropping Columns

A number of columns are simply dropped here. PassengerID, for example, is just a unique identifier, and isn’t helpful in making predictions. While it might be possible to impute the missing values for Cabin, here I’m just dropping the field.

combined <- combined %>%
  select(-c(PassengerId, Name, Ticket, Cabin))

1.3 Data Types

A number of the features/columns in the data set are categorical variables. For example, Pclass describes each person as belonging to one of three categories. Change these variables to factors. Character values are not allowed in the data sets for the learning algorithms, so all must be handled (either dropped or converted). The ‘dataset’ column is the one we added, and we’ll be dropping it later.

combined <- combined %>%
  mutate_at(
    .vars = vars("Survived", "Pclass", "Sex", "Embarked"),
    .funs = funs(as.factor(.))
  )

1.4 Missing Value Imputation

The “NA” column in our summary table let’s us know that several columns have many missing entries. Lots of top-rated kernels go into data imputation. I’m going to use the MLR package to do it faster (but not as well). The missing values in the Survived column are from the test data set (the records we need to predict). Impute them for now - the exact values aren’t important.

The mlr package can impute for all integer fields, character fields, etc. without having to list each one. After the imputation, there are no more missing values in our features. Two more data processing tasks left to show some of the functions in mlr.

# Impute missing values by field type
imp <- impute(
  combined,
  classes = list(
    factor = imputeMode(),
    integer = imputeMean(),
    numeric = imputeMean()
  )
)
combined <- imp$data

# Show column summary
summarizeColumns(combined) %>%
  kable(digits = 2)
name type na mean disp median mad min max nlevs
Survived factor 0 NA 0.26 NA NA 342.00 967.00 2
Pclass factor 0 NA 0.46 NA NA 277.00 709.00 3
Sex factor 0 NA 0.36 NA NA 466.00 843.00 2
Age numeric 0 29.88 12.88 29.88 9.07 0.17 80.00 0
SibSp numeric 0 0.50 1.04 0.00 0.00 0.00 8.00 0
Parch numeric 0 0.39 0.87 0.00 0.00 0.00 9.00 0
Fare numeric 0 33.30 51.74 14.45 10.24 0.00 512.33 0
Embarked factor 0 NA 0.30 NA NA 123.00 916.00 3
dataset character 0 NA 0.32 NA NA 418.00 891.00 2
## Feature Normalizatio n

Fitting almost any model works better when the explanatory features are on the same scale. This is done pretty quickly for all numeric columns. Note that the mean for all numeric columns is 0 afterwards (variance is also standardized).

In the various data processing functions of the mlr package, you can specify the target (predicted) variable in the data set. This will prevent the data processing functions from modifying that variable.

combined <- normalizeFeatures(combined, target = "Survived")

summarizeColumns(combined) %>%
  kable(digits = 2)
name type na mean disp median mad min max nlevs
Survived factor 0 NA 0.26 NA NA 342.00 967.00 2
Pclass factor 0 NA 0.46 NA NA 277.00 709.00 3
Sex factor 0 NA 0.36 NA NA 466.00 843.00 2
Age numeric 0 0 1.00 0.00 0.7 -2.31 3.89 0
SibSp numeric 0 0 1.00 -0.48 0.0 -0.48 7.20 0
Parch numeric 0 0 1.00 -0.44 0.0 -0.44 9.95 0
Fare numeric 0 0 1.00 -0.36 0.2 -0.64 9.26 0
Embarked factor 0 NA 0.30 NA NA 123.00 916.00 3
dataset character 0 NA 0.32 NA NA 418.00 891.00 2

2 Convert factors to dummy variables

All factors must be expanded into numeric dummy columns (one-hot encoding). The MLR package will warn you if you haven’t completed this step. After conversion, note that Pclass now has three fields: Pclass.1-3. Each one is filled with 0 or 1 depending on class.

combined <- createDummyFeatures(
  combined, target = "Survived",
  cols = c(
    "Pclass",
    "Sex",
    "Embarked"
  )
)

summarizeColumns(combined) %>%
  kable(digits = 2)
name type na mean disp median mad min max nlevs
Survived factor 0 NA 0.26 NA NA 342.00 967.00 2
Age numeric 0 0.00 1.00 0.00 0.7 -2.31 3.89 0
SibSp numeric 0 0.00 1.00 -0.48 0.0 -0.48 7.20 0
Parch numeric 0 0.00 1.00 -0.44 0.0 -0.44 9.95 0
Fare numeric 0 0.00 1.00 -0.36 0.2 -0.64 9.26 0
dataset character 0 NA 0.32 NA NA 418.00 891.00 2
Pclass.1 numeric 0 0.25 0.43 0.00 0.0 0.00 1.00 0
Pclass.2 numeric 0 0.21 0.41 0.00 0.0 0.00 1.00 0
Pclass.3 numeric 0 0.54 0.50 1.00 0.0 0.00 1.00 0
Sex.female numeric 0 0.36 0.48 0.00 0.0 0.00 1.00 0
Sex.male numeric 0 0.64 0.48 1.00 0.0 0.00 1.00 0
Embarked.C numeric 0 0.21 0.40 0.00 0.0 0.00 1.00 0
Embarked.Q numeric 0 0.09 0.29 0.00 0.0 0.00 1.00 0
Embarked.S numeric 0 0.70 0.46 1.00 0.0 0.00 1.00 0
We are done p rocessing th e inp ut data . We ne ed to spl it the data fra me back i nto
train and tes t data frame s. Ag ain not e that a lot mor e coul d be done , but the
point of this kernel is t o sho w how t o perfo rm some t asks w ith MLR.
train <- combined %>%
  filter(dataset == "train") %>%
  select(-dataset)

test <- combined %>%
  filter(dataset == "test") %>%
  select(-dataset)

3 Fitting XGBoost

Xgboost is an algorithm in the decision tree family. The first step is to create a task, which is just another term for data set. Create one for both the train and test data sets. The target says which column is the one to predict. Every other column is assumed to be an explanatory feature.

trainTask <- makeClassifTask(data = train, target = "Survived", positive = 1)
testTask <- makeClassifTask(data = test, target = "Survived")

Note: the mlr processing functions used above also work on these task objects. If used, you don’t have to specify the target column since that information is contained in the task object.

Now create a learner and a model. A learner specifies an algorithm while a model pairs it with a task (data set).

set.seed(1)
# Create an xgboost learner that is classification based and outputs
# labels (as opposed to probabilities)
xgb_learner <- makeLearner(
  "classif.xgboost",
  predict.type = "response",
  par.vals = list(
    objective = "binary:logistic",
    eval_metric = "error",
    nrounds = 200
  )
)

# Create a model
xgb_model <- train(xgb_learner, task = trainTask)

Now we can make a prediction. The mlr package assumes that the “Survived” column in the test data set has the correct answers in it. It places these into the “truth” column. In our case, they are all zeros.

result <- predict(xgb_model, testTask)

head(result$data) %>%
  kable()
id truth response
1 0 0
2 0 0
3 0 0
4 0 1
5 0 0
6 0 0

Create a submission file for Kaggle.

prediction <- result$data %>%
  select(PassengerID = id, Survived = response) %>%
  # Put back the original passenger IDs. No sorting has happened, so
  # everything still matches up.
  mutate(PassengerID = test_orig$PassengerId)

#write_csv(prediction, "initial_prediction.csv")

This scored a .73206, and ranked at 6785 on the leader board out of 7567. Pretty much the bottom; however, we achieved that result with a trivial amount of effort. We didn’t even tune our model’s hyper-parameters.

4 Hyper-parameter Tuning

We can improve on the above performance by tuning our hyper-parameters. You can view all the parameters of the xgboost algorithm using the mlr package. A simple approach would be to play with these parameters manually to improve performance.

To read up on the parameters, see here:
http://xgboost.readthedocs.io/en/latest/parameter.html

# To see all the parameters of the xgboost classifier
getParamSet("classif.xgboost")
##                           Type len             Def               Constr
## booster               discrete   -          gbtree gbtree,gblinear,dart
## silent                 integer   -               0          -Inf to Inf
## eta                    numeric   -             0.3               0 to 1
## gamma                  numeric   -               0             0 to Inf
## max_depth              integer   -               6             1 to Inf
## min_child_weight       numeric   -               1             0 to Inf
## subsample              numeric   -               1               0 to 1
## colsample_bytree       numeric   -               1               0 to 1
## colsample_bylevel      numeric   -               1               0 to 1
## num_parallel_tree      integer   -               1             1 to Inf
## lambda                 numeric   -               0             0 to Inf
## lambda_bias            numeric   -               0             0 to Inf
## alpha                  numeric   -               0             0 to Inf
## objective              untyped   - binary:logistic                    -
## eval_metric            untyped   -           error                    -
## base_score             numeric   -             0.5          -Inf to Inf
## max_delta_step         numeric   -               0             0 to Inf
## missing                numeric   -          <NULL>          -Inf to Inf
## nthread                integer   -               -             1 to Inf
## nrounds                integer   -               1             1 to Inf
## feval                  untyped   -          <NULL>                    -
## verbose                integer   -               1               0 to 2
## print_every_n          integer   -               1             1 to Inf
## early_stopping_rounds  integer   -          <NULL>             1 to Inf
## maximize               logical   -          <NULL>                    -
## sample_type           discrete   -         uniform     uniform,weighted
## normalize_type        discrete   -            tree          tree,forest
## rate_drop              numeric   -               0               0 to 1
## skip_drop              numeric   -               0               0 to 1
##                       Req Tunable Trafo
## booster                 -    TRUE     -
## silent                  -   FALSE     -
## eta                     -    TRUE     -
## gamma                   -    TRUE     -
## max_depth               -    TRUE     -
## min_child_weight        -    TRUE     -
## subsample               -    TRUE     -
## colsample_bytree        -    TRUE     -
## colsample_bylevel       -    TRUE     -
## num_parallel_tree       -    TRUE     -
## lambda                  -    TRUE     -
## lambda_bias             -    TRUE     -
## alpha                   -    TRUE     -
## objective               -   FALSE     -
## eval_metric             -   FALSE     -
## base_score              -   FALSE     -
## max_delta_step          -    TRUE     -
## missing                 -   FALSE     -
## nthread                 -   FALSE     -
## nrounds                 -    TRUE     -
## feval                   -   FALSE     -
## verbose                 -   FALSE     -
## print_every_n           Y   FALSE     -
## early_stopping_rounds   -   FALSE     -
## maximize                -   FALSE     -
## sample_type             Y    TRUE     -
## normalize_type          Y    TRUE     -
## rate_drop               Y    TRUE     -
## skip_drop               Y    TRUE     -

The summary table above also lists which parameters can be tuned automatically in the “Tunable” column. The following code will perform this automated tuning. The first step is to define which terms to tune/optimize.

One note about search space: when drawing from a uniform/random distribution between from .01 to 1 for lambda (for example), you won’t adequately search the space on the low end of the range (e.g. .01 - .02). You can increase the number of samples taken in this range using the transfo (transformation) argument in makeParamSet. I have done this in the code below. More info after the code block.

xgb_params <- makeParamSet(
  # The number of trees in the model (each one built sequentially)
  makeIntegerParam("nrounds", lower = 100, upper = 500),
  # number of splits in each tree
  makeIntegerParam("max_depth", lower = 1, upper = 10),
  # "shrinkage" - prevents overfitting
  makeNumericParam("eta", lower = .1, upper = .5),
  # L2 regularization - prevents overfitting
  makeNumericParam("lambda", lower = -1, upper = 0, trafo = function(x) 10^x)
)

For lambda, a random value will be chosen (uniformly) between -1 and 0. That value is then transformed to the parameter using 10 ^ x, meaning that the parameter range is 10^-1 (.1) to 10^0 (1). This will increase the number of samples taken for small values of the parameter, and is effectively sampling on the log scale of the range.

The next step is to define how we will search (random, grid, etc.). We will do random search. On my laptop, I ran 50 iterations in < 1 minute, but it takes longer than 20 minutes in the Kaggle kernel, so I have reduced it. The rest of the script (and what I report as final score), assumes 50 iterations.

control <- makeTuneControlRandom(maxit = 1)

The last setup step is to define how we will evaluate the different sets of randomly-chosen parameters. Here, I am going to use 4-fold cross-validation. In this approach, our training data is split into 4 equal groups. The model is trained on 3 of the four groups and evaluated on the 4th. This process repeats until each of the four groups has been used as the validation set. Performance measures are then averaged into a final score.

# Create a description of the resampling plan
resample_desc <- makeResampleDesc("CV", iters = 4)

With all of our settings complete, we perform the tuning.

tuned_params <- tuneParams(
  learner = xgb_learner,
  task = trainTask,
  resampling = resample_desc,
  par.set = xgb_params,
  control = control
)

After tuning, we can create a new xgboost model using the parameters that gave the best results. We then train and predict using that new model.

# Create a new model using tuned hyperparameters
xgb_tuned_learner <- setHyperPars(
  learner = xgb_learner,
  par.vals = tuned_params$x
)

# Re-train parameters using tuned hyperparameters (and full training set)
xgb_model <- train(xgb_tuned_learner, trainTask)

# Make a new prediction
result <- predict(xgb_model, testTask)
prediction <- result$data %>%
  select(PassengerID = id, Survived = response) %>%
  # Put back the original passenger IDs. No sorting has happened, so
  # everything still matches up.
  mutate(PassengerID = test_orig$PassengerId)

#write_csv(prediction, "final_prediction.csv")

Tuning the hyper-parameters increased the score to .76077 with a rank of 5973 out of 7472. Further improvements could be gained by doing more refined imputation, feature creation, better tuning, etc.

5 XGBoost tutorial

5.1 Why is it so good ?

XGBoost (Extreme Gradient Boosting) is an optimized distributed gradient boosting library.

  • Parallel Computing: It is enabled with parallel processing (using OpenMP); i.e., when you run xgboost, by default, it would use all the cores of your laptop/machine.

  • Regularization: I believe this is the biggest advantage of xgboost. GBM has no provision for regularization. Regularization is a technique used to avoid overfitting in linear and tree-based models.

  • Enabled Cross Validation: In R, we usually use external packages such as caret and mlr to obtain CV results. But, xgboost is enabled with internal CV function (we’ll see below).

  • Missing Values: XGBoost is designed to handle missing values internally. The missing values are treated in such a manner that if there exists any trend in missing values, it is captured by the model.

  • Flexibility: In addition to regression, classification, and ranking problems, it supports user-defined objective functions also. An objective function is used to measure the performance of the model given a certain set of parameters. Furthermore, it supports user defined evaluation metrics as well.

  • Availability: Currently, it is available for programming languages such as R, Python, Java, Julia, and Scala.

  • Save and Reload: XGBoost gives us a feature to save our data matrix and model and reload it later. Suppose, we have a large data set, we can simply save the model and use it in future instead of wasting time redoing the computation.

  • Tree Pruning: Unlike GBM, where tree pruning stops once a negative loss is encountered, XGBoost grows the tree upto max_depth and then prune backward until the improvement in loss function is below a threshold.

5.2 How does XGBoost work

XGBoost belongs to a family of boosting algorithms that convert weak learners into strong learners. A weak learner is one which is slightly better than random guessing. Let’s understand boosting first (in general).

Boosting is a sequential process; i.e., trees are grown using the information from a previously grown tree one after the other. This process slowly learns from data and tries to improve its prediction in subsequent iterations. Let’s look at a classic classification example:

Four classifiers (in 4 boxes), shown above, are trying hard to classify + and - classes as homogeneously as possible. Let’s understand this picture well.

  • Box 1: The first classifier creates a vertical line (split) at D1. It says anything to the left of D1 is + and anything to the right of D1 is -. However, this classifier misclassifies three + points.

  • Box 2: The next classifier says don’t worry I will correct your mistakes. Therefore, it gives more weight to the three + misclassified points (see bigger size of +) and creates a vertical line at D2. Again it says, anything to right of D2 is - and left is +. Still, it makes mistakes by incorrectly classifying three - points.

  • Box 3: The next classifier continues to bestow support. Again, it gives more weight to the three - misclassified points and creates a horizontal line at D3. Still, this classifier fails to classify the points (in circle) correctly. Remember that each of these classifiers has a misclassification error associated with them.

Boxes 1,2, and 3 are weak classifiers. These classifiers will now be used to create a strong classifier Box 4.

  • Box 4: It is a weighted combination of the weak classifiers. As you can see, it does good job at classifying all the points correctly.

That’s the basic idea behind boosting algorithms. The very next model capitalizes on the misclassification/error of previous model and tries to reduce it. Now, let’s come to XGBoost.

As we know, XGBoost can used to solve both regression and classification problems. It is enabled with separate methods to solve respective problems. Let’s see:

Classification Problems: To solve such problems, it uses booster = gbtree parameter; i.e., a tree is grown one after other and attempts to reduce misclassification rate in subsequent iterations. In this, the next tree is built by giving a higher weight to misclassified points by the previous tree (as explained above).

Regression Problems: To solve such problems, we have two methods: booster = gbtree and booster = gblinear. You already know gbtree. In gblinear, it builds generalized linear model and optimizes it using regularization (L1,L2) and gradient descent. In this, the subsequent models are built on residuals (actual - predicted) generated by previous iterations. Are you wondering what is gradient descent? Understanding gradient descent requires math, however, let me try and explain it in simple words:

  • Gradient Descent: It is a method which comprises a vector of weights (or coefficients) where we calculate their partial derivative with respective to zero. The motive behind calculating their partial derivative is to find the local minima of the loss function (RSS), which is convex in nature. In simple words, gradient descent tries to optimize the loss function by tuning different values of coefficients to minimize the error.

5.3 Understanding XGBoost Tuning Parameters

Every parameter has a significant role to play in the model’s performance. Before hypertuning, let’s first understand about these parameters and their importance. In this article, I’ve only explained the most frequently used and tunable parameters. To look at all the parameters, you can refer to its official documentation.

XGBoost parameters can be divided into three categories (as suggested by its authors):

  • General Parameters: Controls the booster type in the model which eventually drives overall functioning

  • Booster Parameters: Controls the performance of the selected booster

  • Learning Task Parameters: Sets and evaluates the learning process of the booster from the given data

1. General Parameters

  • Booster[default=gbtree]
    • Sets the booster type (gbtree, gblinear or dart) to use. For classification problems, you can use gbtree, dart. For regression, you can use any.
  • nthread[default=maximum cores available]
    • Activates parallel computation. Generally, people don’t change it as using maximum cores leads to the fastest computation.
  • silent[default=0]
    • If you set it to 1, your R console will get flooded with running messages. Better not to change it.

2. Booster Parameters

As mentioned above, parameters for tree and linear boosters are different. Let’s understand each one of them:

Parameters for Tree Booster

  • nrounds[default=100]
    • It controls the maximum number of iterations. For classification, it is similar to the number of trees to grow.
    • Should be tuned using CV
  • eta[default=0.3][range: (0,1)]
    • It controls the learning rate, i.e., the rate at which our model learns patterns in data. After every round, it shrinks the feature weights to reach the best optimum.
    • Lower eta leads to slower computation. It must be supported by increase in nrounds.
    • Typically, it lies between 0.01 - 0.3
  • gamma[default=0][range: (0,Inf)]
    • It controls regularization (or prevents overfitting). The optimal value of gamma depends on the data set and other parameter values.
    • Higher the value, higher the regularization. Regularization means penalizing large coefficients which don’t improve the model’s performance. default = 0 means no regularization.
    • Tune trick: Start with 0 and check CV error rate. If you see train error >>> test error, bring gamma into action. Higher the gamma, lower the difference in train and test CV. If you have no clue what value to use, use gamma=5 and see the performance. Remember that gamma brings improvement when you want to use shallow (low max_depth) trees.
  • max_depth[default=6][range: (0,Inf)]
    • It controls the depth of the tree.
    • Larger the depth, more complex the model; higher chances of overfitting. There is no standard value for max_depth. Larger data sets require deep trees to learn the rules from data.
    • Should be tuned using CV
  • min_child_weight[default=1][range:(0,Inf)]
    • In regression, it refers to the minimum number of instances required in a child node. In classification, if the leaf node has a minimum sum of instance weight (calculated by second order partial derivative) lower than min_child_weight, the tree splitting stops.
    • In simple words, it blocks the potential feature interactions to prevent overfitting. Should be tuned using CV.
  • subsample[default=1][range: (0,1)]
    • It controls the number of samples (observations) supplied to a tree.
    • Typically, its values lie between (0.5-0.8)
  • colsample_bytree[default=1][range: (0,1)]
    • It control the number of features (variables) supplied to a tree +Typically, its values lie between (0.5,0.9)
  • lambda[default=0]
    • It controls L2 regularization (equivalent to Ridge regression) on weights. It is used to avoid overfitting.
  • alpha[default=1]
    • It controls L1 regularization (equivalent to Lasso regression) on weights. + In addition to shrinkage, enabling alpha also results in feature selection. Hence, it’s more useful on high dimensional data sets.

Parameters for Linear Booster

Using linear booster has relatively lesser parameters to tune, hence it computes much faster than gbtree booster.

  • nrounds[default=100]
    • It controls the maximum number of iterations (steps) required for gradient descent to converge.
    • Should be tuned using CV
  • lambda[default=0]
    • It enables Ridge Regression. Same as above alpha[default=1]
    • It enables Lasso Regression. Same as above

3. Learning Task Parameters

These parameters specify methods for the loss function and model evaluation. In addition to the parameters listed below, you are free to use a customized objective / evaluation function.

  • Objective[default=reg:linear]
    • reg:linear - for linear regression
    • binary:logistic - logistic regression for binary classification. It returns class probabilities
    • multi:softmax - multiclassification using softmax objective. It returns predicted class labels. It requires setting num_class parameter denoting number of unique prediction classes.
    • multi:softprob - multiclassification using softmax objective. It returns predicted class probabilities.
  • eval_metric [no default, depends on objective selected]
    • These metrics are used to evaluate a model’s accuracy on validation data. For regression, default metric is RMSE. For classification, default metric is error.
    • Available error functions are as follows:
      • mae - Mean Absolute Error (used in regression)
      • Logloss - Negative loglikelihood (used in classification)
      • AUC - Area under curve (used in classification)
      • RMSE - Root mean square error (used in regression)
      • error - Binary classification error rate [#wrong cases/#all cases]
      • mlogloss - multiclass logloss (used in classification)

6 Practical - Tuning XGBoost in R

In this practical section, we’ll learn to tune xgboost in two ways: using the xgboost package and MLR package.

I’ll use the adult data set , this data set poses a classification problem where our job is to predict if the given user will have a salary <=50K or >50K.

I’ll follow the most common but effective steps in parameter tuning:

  • First, you build the xgboost model using default parameters. You might be surprised to see that default parameters sometimes give impressive accuracy.
  • If you get a depressing model accuracy, do this: fix eta = 0.1, leave the rest of the parameters at default value, using xgb.cv function get best n_rounds. Now, build a model with these parameters and check the accuracy.
  • Otherwise, you can perform a grid search on rest of the parameters (max_depth, gamma, subsample, colsample_bytree etc) by fixing eta and nrounds. Note: If using gbtree, don’t introduce gamma until you see a significant difference in your train and test error.
  • Using the best parameters from grid search, tune the regularization parameters(alpha,lambda) if required.
  • At last, increase/decrease eta and follow the procedure. But remember, excessively lower eta values would allow the model to learn deep interactions in the data and in this process, it might capture noise. So be careful!
#load libraries
library(data.table)
## Warning: package 'data.table' was built under R version 3.4.2
## 
## Attaching package: 'data.table'
## The following objects are masked from 'package:dplyr':
## 
##     between, first, last
## The following object is masked from 'package:purrr':
## 
##     transpose
library(mlr)

#set variable names
setcol <- c("age",
            "workclass",
            "fnlwgt",
            "education",
            "education-num",
            "marital-status",
            "occupation",
            "relationship",
            "race",
            "sex",
            "capital-gain",
            "capital-loss",
            "hours-per-week",
            "native-country",
            "target")

#load data
train <- read.table("xgboost_adultdata.data",header = F,sep = ",",col.names = setcol,na.strings = c(" ?"),stringsAsFactors = F)
test <- read.table("xgboost_adulttest.test",header = F,sep = ",",col.names = setcol,skip = 1, na.strings = c(" ?"),stringsAsFactors = F)

#convert data frame to data table
setDT(train)
setDT(test)

#check missing values
table(is.na(train))
## 
##  FALSE   TRUE 
## 484153   4262
sapply(train, function(x) sum(is.na(x))/length(x))*100
##            age      workclass         fnlwgt      education  education.num 
##       0.000000       5.638647       0.000000       0.000000       0.000000 
## marital.status     occupation   relationship           race            sex 
##       0.000000       5.660146       0.000000       0.000000       0.000000 
##   capital.gain   capital.loss hours.per.week native.country         target 
##       0.000000       0.000000       0.000000       1.790486       0.000000
table(is.na(test))
## 
##  FALSE   TRUE 
## 242012   2203
sapply(test, function(x) sum(is.na(x))/length(x))*100
##            age      workclass         fnlwgt      education  education.num 
##       0.000000       5.914870       0.000000       0.000000       0.000000 
## marital.status     occupation   relationship           race            sex 
##       0.000000       5.933296       0.000000       0.000000       0.000000 
##   capital.gain   capital.loss hours.per.week native.country         target 
##       0.000000       0.000000       0.000000       1.682943       0.000000
#quick data cleaning
#remove extra character from target variable
library(stringr)
test[,target := substr(target,start = 1,stop = nchar(target)-1)]

#remove leading whitespaces
char_col <- colnames(train)[sapply(test,is.character)]
for(i in char_col)
      set(train,j=i,value = str_trim(train[[i]],side = "left"))
for(i in char_col)
      set(test,j=i,value = str_trim(test[[i]],side = "left"))

#set all missing value as "Missing"
train[is.na(train)] <- "Missing"
test[is.na(test)] <- "Missing"

To use xgboost package, keep these things in mind: + Convert the categorical variables into numeric using one hot encoding + For classification, if the dependent variable belongs to class factor, convert it to numeric

R’s base function model.matrix is quick enough to implement one hot encoding. In the code below, ~.+0 leads to encoding of all categorical variables without producing an intercept. Alternatively, you can use the dummies package to accomplish the same task. Since xgboost package accepts target variable separately, we’ll do the encoding keeping this in mind:

#using one hot encoding
labels <- train$target
ts_label <- test$target
new_tr <- model.matrix(~.+0,data = train[,-c("target"),with=F])
new_ts <- model.matrix(~.+0,data = test[,-c("target"),with=F])

#convert factor to numeric
labels <- as.numeric(as.factor(labels))-1
ts_label <- as.numeric(as.factor(ts_label))-1

For xgboost, we’ll use xgb.DMatrix to convert data table into a matrix (most recommended):

#preparing matrix
dtrain <- xgb.DMatrix(data = new_tr,label = labels)
dtest <- xgb.DMatrix(data = new_ts,label=ts_label)

#default parameters
params <- list(
        booster = "gbtree",
        objective = "binary:logistic",
        eta=0.3,
        gamma=0,
        max_depth=6,
        min_child_weight=1,
        subsample=1,
        colsample_bytree=1
)

xgbcv <- xgb.cv(params = params
                ,data = dtrain
                ,nrounds = 100
                ,nfold = 5
                ,showsd = T
                ,stratified = T
                ,print.every.n = 10
                ,early.stop.round = 20
                ,maximize = F
)
## Warning: 'print.every.n' is deprecated.
## Use 'print_every_n' instead.
## See help("Deprecated") and help("xgboost-deprecated").
## Warning: 'early.stop.round' is deprecated.
## Use 'early_stopping_rounds' instead.
## See help("Deprecated") and help("xgboost-deprecated").
## [1]  train-error:0.143607+0.001799   test-error:0.145450+0.004040 
## Multiple eval metrics are present. Will use test_error for early stopping.
## Will train until test_error hasn't improved in 20 rounds.
## 
## [11] train-error:0.130901+0.001264   test-error:0.136298+0.003846 
## [21] train-error:0.119975+0.001381   test-error:0.129971+0.004189 
## [31] train-error:0.114570+0.000965   test-error:0.128129+0.004159 
## [41] train-error:0.111038+0.000738   test-error:0.127084+0.004922 
## [51] train-error:0.107990+0.000382   test-error:0.127422+0.004602 
## [61] train-error:0.104987+0.001369   test-error:0.127422+0.004747 
## Stopping. Best iteration:
## [47] train-error:0.109387+0.000237   test-error:0.126593+0.004664
##best iteration = 79

min(xgbcv$test.error.mean)
## Warning in min(xgbcv$test.error.mean): no non-missing arguments to min;
## returning Inf
## [1] Inf
#0.1263

#first default - model training
xgb1 <- xgb.train(
           params = params
          ,data = dtrain
          ,nrounds = 79
          ,watchlist = list(val=dtest,train=dtrain)
          ,print.every.n = 10
          ,early.stop.round = 10
          ,maximize = F
          ,eval_metric = "error"
)
## Warning: 'print.every.n' is deprecated.
## Use 'print_every_n' instead.
## See help("Deprecated") and help("xgboost-deprecated").

## Warning: 'early.stop.round' is deprecated.
## Use 'early_stopping_rounds' instead.
## See help("Deprecated") and help("xgboost-deprecated").
## [1]  val-error:0.143726  train-error:0.144805 
## Multiple eval metrics are present. Will use train_error for early stopping.
## Will train until train_error hasn't improved in 10 rounds.
## 
## [11] val-error:0.131073  train-error:0.131568 
## [21] val-error:0.127879  train-error:0.122140 
## [31] val-error:0.126589  train-error:0.115168 
## [41] val-error:0.125914  train-error:0.111821 
## [51] val-error:0.125914  train-error:0.110347 
## [61] val-error:0.126466  train-error:0.109149 
## [71] val-error:0.126466  train-error:0.106938 
## [79] val-error:0.126282  train-error:0.105095
#model prediction
xgbpred <- predict(xgb1,dtest)
xgbpred <- ifelse(xgbpred > 0.5,1,0)

#confusion matrix
library(caret)
## Loading required package: lattice
## 
## Attaching package: 'caret'
## The following object is masked from 'package:mlr':
## 
##     train
## The following object is masked from 'package:purrr':
## 
##     lift
confusionMatrix(xgbpred, ts_label)
## Confusion Matrix and Statistics
## 
##           Reference
## Prediction     0     1
##          0 11800  1421
##          1   635  2425
##                                           
##                Accuracy : 0.8737          
##                  95% CI : (0.8685, 0.8788)
##     No Information Rate : 0.7638          
##     P-Value [Acc > NIR] : < 2.2e-16       
##                                           
##                   Kappa : 0.6235          
##  Mcnemar's Test P-Value : < 2.2e-16       
##                                           
##             Sensitivity : 0.9489          
##             Specificity : 0.6305          
##          Pos Pred Value : 0.8925          
##          Neg Pred Value : 0.7925          
##              Prevalence : 0.7638          
##          Detection Rate : 0.7248          
##    Detection Prevalence : 0.8121          
##       Balanced Accuracy : 0.7897          
##                                           
##        'Positive' Class : 0               
## 
#Accuracy - 86.54%

#view variable importance plot
mat <- xgb.importance(feature_names = colnames(new_tr),model = xgb1)
xgb.plot.importance(importance_matrix = mat[1:20]) #first 20 variables

Let’s proceed to the random / grid search procedure and attempt to find better accuracy. From here on, we’ll be using the MLR package for model building. A quick reminder, the MLR package creates its own frame of data, learner as shown below. Also, keep in mind that task functions in mlr doesn’t accept character variables. Hence, we need to convert them to factors before creating task:

#convert characters to factors
fact_col <- colnames(train)[sapply(train,is.character)]
for(i in fact_col)
        set(train,j=i,value = factor(train[[i]]))
for(i in fact_col)
        set(test,j=i,value = factor(test[[i]]))

#create tasks
traintask <- makeClassifTask(data = train,target = "target")
## Warning in makeTask(type = type, data = data, weights = weights, blocking
## = blocking, : Provided data is not a pure data.frame but from class
## data.table, hence it will be converted.
testtask <- makeClassifTask(data = test,target = "target")
## Warning in makeTask(type = type, data = data, weights = weights, blocking
## = blocking, : Provided data is not a pure data.frame but from class
## data.table, hence it will be converted.
#do one hot encoding
traintask <- createDummyFeatures(obj = traintask)
testtask <- createDummyFeatures(obj = testtask)
#create learner
lrn <- makeLearner("classif.xgboost",predict.type = "response")
lrn$par.vals <- list(
             objective="binary:logistic",
             eval_metric="error",
             nrounds=1L,
             eta=0.1
)

#set parameter space
params <- makeParamSet(
         makeDiscreteParam("booster",values = c("gbtree","gblinear")),
         makeIntegerParam("max_depth",lower = 3L,upper = 10L),
         makeNumericParam("min_child_weight",lower = 1L,upper = 10L),
         makeNumericParam("subsample",lower = 0.5,upper = 1),
         makeNumericParam("colsample_bytree",lower = 0.5,upper = 1)
)

#set resampling strategy
rdesc <- makeResampleDesc("CV",stratify = T,iters=5L)

#search strategy
ctrl <- makeTuneControlRandom(maxit = 5L)

#set parallel backend
#library(parallel)
#library(parallelMap)
#parallelStartSocket(cpus = 2)

#parameter tuning
mytune <- tuneParams(learner = lrn
               ,task = traintask
               ,resampling = rdesc
               ,measures = acc
               ,par.set = params
               ,control = ctrl
               ,show.info = T)
## [Tune] Started tuning learner classif.xgboost for parameter set:
##                      Type len Def          Constr Req Tunable Trafo
## booster          discrete   -   - gbtree,gblinear   -    TRUE     -
## max_depth         integer   -   -         3 to 10   -    TRUE     -
## min_child_weight  numeric   -   -         1 to 10   -    TRUE     -
## subsample         numeric   -   -        0.5 to 1   -    TRUE     -
## colsample_bytree  numeric   -   -        0.5 to 1   -    TRUE     -
## With control class: TuneControlRandom
## Imputation value: -0
## [Tune-x] 1: booster=gblinear; max_depth=4; min_child_weight=9.89; subsample=0.773; colsample_bytree=0.52
## [1]  train-error:0.239203 
## [1]  train-error:0.239126 
## [1]  train-error:0.239289 
## [1]  train-error:0.238397 
## [1]  train-error:0.239357
## [Tune-y] 1: acc.test.mean=0.761; time: 0.0 min
## [Tune-x] 2: booster=gbtree; max_depth=8; min_child_weight=6.76; subsample=0.872; colsample_bytree=0.651
## [1]  train-error:0.143077 
## [1]  train-error:0.141003 
## [1]  train-error:0.144157 
## [1]  train-error:0.141003 
## [1]  train-error:0.144497
## [Tune-y] 2: acc.test.mean=0.854; time: 0.0 min
## [Tune-x] 3: booster=gbtree; max_depth=3; min_child_weight=7.23; subsample=0.694; colsample_bytree=0.805
## [1]  train-error:0.155630 
## [1]  train-error:0.155591 
## [1]  train-error:0.156941 
## [1]  train-error:0.156666 
## [1]  train-error:0.156590
## [Tune-y] 3: acc.test.mean=0.844; time: 0.0 min
## [Tune-x] 4: booster=gbtree; max_depth=5; min_child_weight=6.51; subsample=0.993; colsample_bytree=0.528
## [1]  train-error:0.153173 
## [1]  train-error:0.152981 
## [1]  train-error:0.147151 
## [1]  train-error:0.153864 
## [1]  train-error:0.152443
## [Tune-y] 4: acc.test.mean=0.847; time: 0.0 min
## [Tune-x] 5: booster=gbtree; max_depth=9; min_child_weight=5.68; subsample=0.679; colsample_bytree=0.62
## [1]  train-error:0.142194 
## [1]  train-error:0.141656 
## [1]  train-error:0.140356 
## [1]  train-error:0.140312 
## [1]  train-error:0.139621
## [Tune-y] 5: acc.test.mean=0.854; time: 0.0 min
## [Tune] Result: booster=gbtree; max_depth=8; min_child_weight=6.76; subsample=0.872; colsample_bytree=0.651 : acc.test.mean=0.854
mytune$y #0.873069
## acc.test.mean 
##      0.854427
#set hyperparameters
lrn_tune <- setHyperPars(lrn,par.vals = mytune$x)

#train model
xgmodel <- mlr::train(learner = lrn_tune,task = traintask)
## [1]  train-error:0.143515
#predict model
xgpred <- predict(xgmodel,testtask)

confusionMatrix(xgpred$data$response,xgpred$data$truth)
## Confusion Matrix and Statistics
## 
##           Reference
## Prediction <=50K  >50K
##      <=50K 11852  1767
##      >50K    583  2079
##                                          
##                Accuracy : 0.8557         
##                  95% CI : (0.8502, 0.861)
##     No Information Rate : 0.7638         
##     P-Value [Acc > NIR] : < 2.2e-16      
##                                          
##                   Kappa : 0.5524         
##  Mcnemar's Test P-Value : < 2.2e-16      
##                                          
##             Sensitivity : 0.9531         
##             Specificity : 0.5406         
##          Pos Pred Value : 0.8703         
##          Neg Pred Value : 0.7810         
##              Prevalence : 0.7638         
##          Detection Rate : 0.7280         
##    Detection Prevalence : 0.8365         
##       Balanced Accuracy : 0.7468         
##                                          
##        'Positive' Class : <=50K          
## 
#Accuracy : 0.8747

#stop parallelization
#parallelStop()
LS0tCnRpdGxlOiA8Y2VudGVyPiBYZ2Jvb3N0IHVzaW5nIE1MUiBwYWNrYWdlIDwvY2VudGVyPgpzdWJ0aXRsZTogPGNlbnRlcj4gPC9jZW50ZXI+CmF1dGhvcjogPGNlbnRlcj4gT2xlZyBCYXlkYWtvdiA8L2NlbnRlcj4KZGF0ZTogPGNlbnRlcj4gRGVjZW1iZXIgMDIsIDIwMTcgPC9jZW50ZXI+Cm91dHB1dDogCiAgaHRtbF9kb2N1bWVudDogCiAgICBjb2RlX2Rvd25sb2FkOiB0cnVlCiAgICBjb2RlX2ZvbGRpbmc6IHNob3cKICAgIG51bWJlcl9zZWN0aW9uczogeWVzCiAgICB0aGVtZTogam91cm5hbAogICAgZGZfcHJpbnQ6IGthYmxlCiAgICB0b2M6IFRSVUUKICAgIHRvY19mbG9hdDogVFJVRQotLS0KCjxici8+CjxjZW50ZXI+IDxoNT4gVGhpcyBpcyBhICoqc2ltcGxpZmllZCB2ZXJzaW9uKiogb2YgdGhlIHByb2dyYW0gdXNlZCBmb3IgdGhlIEthZ2dsZSBjb21wZXRpdGlvbiAgaHR0cHM6Ly93d3cua2FnZ2xlLmNvbS9ka3lsZXdhcmQveGdib29zdC11c2luZy1tbHItcGFja2FnZS1yL2RhdGEgPC9oNT48L2NlbnRlcj4KPGJyLz4KClRoZSBwdXJwb3NlIG9mIHRoaXMgcmVwb3J0IGlzIHRvIHNob3cgdGhlIChyZWxhdGl2ZSkgc2ltcGxpY2l0eSBvZiBpbXBsZW1lbnRpbmcgeGdib29zdCB3aXRoIHRoZSBNTFIgcGFja2FnZSBpbiBSLiBNTFIgc3VwcG9ydHMgYSB3aWRlIHJhbmdlIG9mIGxlYXJuaW5nIGFsZ29yaXRobXMsIHdoaWNoIGNhbiBiZSBzd2l0Y2hlZCBvdXQgZWFzaWx5LCB0b28uIAoKRm9yIG11Y2ggbW9yZSBpbmZvcm1hdGlvbiBvbiB0aGUgTUxSIHBhY2thZ2UsIHNlZSB0aGUgdHV0b3JpYWwgaGVyZTogaHR0cHM6Ly9tbHItb3JnLmdpdGh1Yi5pby9tbHItdHV0b3JpYWwvcmVsZWFzZS9odG1sL2luZGV4Lmh0bWwKCmBgYHtyIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CmxpYnJhcnkodGlkeXZlcnNlKSAjIGRhdGEgbWFuaXB1bGF0aW9uCmxpYnJhcnkobWxyKSAgICAgICAjIE1MIHBhY2thZ2UgKGFsc28gc29tZSBkYXRhIG1hbmlwdWxhdGlvbikKbGlicmFyeShrbml0cikgICAgICMganVzdCB1c2luZyB0aGlzIGZvciBrYWJsZSgpIHRvIG1ha2UgcHJldHR5IHRhYmxlcwpsaWJyYXJ5KHhnYm9vc3QpCiMgVGhlICd4Z2Jvb3N0JyBsaWJyYXJ5IG11c3QgYmUgaW5zdGFsbGVkIC0gZG9lc24ndCBuZWVkIHRvIGJlIGxvYWRlZAp0cmFpbl9vcmlnIDwtIHJlYWRfY3N2KCJ4Z2Jvb3N0X3RyYWluLmNzdiIpCnRlc3Rfb3JpZyA8LSByZWFkX2NzdigieGdib29zdF90ZXN0LmNzdiIpCmBgYAoKCiMgRGF0YSBwcmVwYXJhdGlvbiB7LnRhYnNldH0KCiMjIERhdGEgY2xlYW5pbmcKRmlyc3QsIEkgY29tYmluZSB0aGUgdHJhaW4gYW5kIHRlc3QgZGF0YSB0b2dldGhlciBzbyB0aGF0IGNsZWFuaW5nIG9ubHkgbmVlZHMgdG8KYmUgZG9uZSBvbmNlIGFuZCBhbnkgYXZlcmFnZXMgKG9yIG90aGVyIHN0YXRzKSBhcmUgbW9yZSBhY2N1cmF0ZS4gQ3JlYXRpbmcgYSBuZXcKY29sdW1uIHRvIG1hcmsgZWFjaCBkYXRhIHNldCBhbGxvd3MgbWUgdG8gZWFzaWx5IHNlcGFyYXRlIHRoZW0gYWdhaW4gYWZ0ZXIKY2xlYW5pbmcuCgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KdHJhaW4gPC0gdHJhaW5fb3JpZyAlPiUKICBtdXRhdGUoZGF0YXNldCA9ICJ0cmFpbiIpCgp0ZXN0IDwtIHRlc3Rfb3JpZyAlPiUKICBtdXRhdGUoZGF0YXNldCA9ICJ0ZXN0IikKCmNvbWJpbmVkIDwtIGJpbmRfcm93cyh0cmFpbiwgdGVzdCkKYGBgCgpbTUxSXShodHRwOi8vbWxyLW9yZy5naXRodWIuaW8vKSBpcyBhIGxpYnJhcnkgZm9yIG1hY2hpbmUgbGVhcm5pbmcsIGFuZCBpdCBjb250YWlucwptYW55IHVzZWZ1bCB0b29scyBmb3IgZGF0YSBzY2llbmNlIGluIGdlbmVyYWwuIEZvciBleGFtcGxlLCB0aGUgCmBzdW1tYXJpemVDb2x1bW5zKClgIGZ1bmN0aW9uIGlzIGdyZWF0IGZvciBnZXR0aW5nIGEgcXVpY2sgb3ZlcnZpZXcgb2YgdGhlIGRhdGEuCgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0Kc3VtbWFyaXplQ29sdW1ucyhjb21iaW5lZCkgJT4lCiAga2FibGUoZGlnaXRzID0gMikKYGBgCgojIyBEcm9wcGluZyBDb2x1bW5zCkEgbnVtYmVyIG9mIGNvbHVtbnMgYXJlIHNpbXBseSBkcm9wcGVkIGhlcmUuIFBhc3NlbmdlcklELCBmb3IgZXhhbXBsZSwgaXMganVzdAphIHVuaXF1ZSBpZGVudGlmaWVyLCBhbmQgaXNuJ3QgaGVscGZ1bCBpbiBtYWtpbmcgcHJlZGljdGlvbnMuIFdoaWxlIGl0IG1pZ2h0IGJlCnBvc3NpYmxlIHRvIGltcHV0ZSB0aGUgbWlzc2luZyB2YWx1ZXMgZm9yIENhYmluLCBoZXJlIEknbSBqdXN0IGRyb3BwaW5nIHRoZQpmaWVsZC4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQpjb21iaW5lZCA8LSBjb21iaW5lZCAlPiUKICBzZWxlY3QoLWMoUGFzc2VuZ2VySWQsIE5hbWUsIFRpY2tldCwgQ2FiaW4pKQpgYGAKIyMgRGF0YSBUeXBlcwpBIG51bWJlciBvZiB0aGUgZmVhdHVyZXMvY29sdW1ucyBpbiB0aGUgZGF0YSBzZXQgYXJlIGNhdGVnb3JpY2FsIHZhcmlhYmxlcy4gRm9yCmV4YW1wbGUsIFBjbGFzcyBkZXNjcmliZXMgZWFjaCBwZXJzb24gYXMgYmVsb25naW5nIHRvIG9uZSBvZiB0aHJlZSBjYXRlZ29yaWVzLgpDaGFuZ2UgdGhlc2UgdmFyaWFibGVzIHRvIGZhY3RvcnMuIENoYXJhY3RlciB2YWx1ZXMgYXJlIG5vdCBhbGxvd2VkIGluIHRoZQpkYXRhIHNldHMgZm9yIHRoZSBsZWFybmluZyBhbGdvcml0aG1zLCBzbyBhbGwgbXVzdCBiZSBoYW5kbGVkIChlaXRoZXIgZHJvcHBlZCBvcgpjb252ZXJ0ZWQpLiBUaGUgJ2RhdGFzZXQnIGNvbHVtbiBpcyB0aGUgb25lIHdlIGFkZGVkLCBhbmQgd2UnbGwgYmUgZHJvcHBpbmcgaXQKbGF0ZXIuCgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KY29tYmluZWQgPC0gY29tYmluZWQgJT4lCiAgbXV0YXRlX2F0KAogICAgLnZhcnMgPSB2YXJzKCJTdXJ2aXZlZCIsICJQY2xhc3MiLCAiU2V4IiwgIkVtYmFya2VkIiksCiAgICAuZnVucyA9IGZ1bnMoYXMuZmFjdG9yKC4pKQogICkKYGBgCiMjIE1pc3NpbmcgVmFsdWUgSW1wdXRhdGlvbgpUaGUgIk5BIiBjb2x1bW4gaW4gb3VyIHN1bW1hcnkgdGFibGUgbGV0J3MgdXMga25vdyB0aGF0IHNldmVyYWwgY29sdW1ucyBoYXZlIG1hbnkKbWlzc2luZyBlbnRyaWVzLiBMb3RzIG9mIHRvcC1yYXRlZCBrZXJuZWxzIGdvIGludG8gZGF0YSBpbXB1dGF0aW9uLiBJJ20gZ29pbmcKdG8gdXNlIHRoZSBNTFIgcGFja2FnZSB0byBkbyBpdCBmYXN0ZXIgKGJ1dCBub3QgYXMgd2VsbCkuIFRoZSBtaXNzaW5nIHZhbHVlcyBpbgp0aGUgU3Vydml2ZWQgY29sdW1uIGFyZSBmcm9tIHRoZSB0ZXN0IGRhdGEgc2V0ICh0aGUgcmVjb3JkcyB3ZSBuZWVkIHRvIHByZWRpY3QpLgpJbXB1dGUgdGhlbSBmb3Igbm93IC0gdGhlIGV4YWN0IHZhbHVlcyBhcmVuJ3QgaW1wb3J0YW50LgoKVGhlIG1sciBwYWNrYWdlIGNhbiBpbXB1dGUgZm9yIGFsbCBpbnRlZ2VyIGZpZWxkcywgY2hhcmFjdGVyIGZpZWxkcywgZXRjLgp3aXRob3V0IGhhdmluZyB0byBsaXN0IGVhY2ggb25lLiBBZnRlciB0aGUgaW1wdXRhdGlvbiwgdGhlcmUgYXJlIG5vIG1vcmUgbWlzc2luZwp2YWx1ZXMgaW4gb3VyIGZlYXR1cmVzLiBUd28gbW9yZSBkYXRhIHByb2Nlc3NpbmcgdGFza3MgbGVmdCB0byBzaG93IHNvbWUgb2YgdGhlCmZ1bmN0aW9ucyBpbiBtbHIuCgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KIyBJbXB1dGUgbWlzc2luZyB2YWx1ZXMgYnkgZmllbGQgdHlwZQppbXAgPC0gaW1wdXRlKAogIGNvbWJpbmVkLAogIGNsYXNzZXMgPSBsaXN0KAogICAgZmFjdG9yID0gaW1wdXRlTW9kZSgpLAogICAgaW50ZWdlciA9IGltcHV0ZU1lYW4oKSwKICAgIG51bWVyaWMgPSBpbXB1dGVNZWFuKCkKICApCikKY29tYmluZWQgPC0gaW1wJGRhdGEKCiMgU2hvdyBjb2x1bW4gc3VtbWFyeQpzdW1tYXJpemVDb2x1bW5zKGNvbWJpbmVkKSAlPiUKICBrYWJsZShkaWdpdHMgPSAyKQpgYGAKIyMgRmVhdHVyZSBOb3JtYWxpemF0aW9uCgpGaXR0aW5nIGFsbW9zdCBhbnkgbW9kZWwgd29ya3MgYmV0dGVyIHdoZW4gdGhlIGV4cGxhbmF0b3J5IGZlYXR1cmVzIGFyZSBvbiB0aGUKc2FtZSBzY2FsZS4gVGhpcyBpcyBkb25lIHByZXR0eSBxdWlja2x5IGZvciBhbGwgbnVtZXJpYyBjb2x1bW5zLiBOb3RlIHRoYXQgdGhlCm1lYW4gZm9yIGFsbCBudW1lcmljIGNvbHVtbnMgaXMgMCBhZnRlcndhcmRzICh2YXJpYW5jZSBpcyBhbHNvIHN0YW5kYXJkaXplZCkuCgpJbiB0aGUgdmFyaW91cyBkYXRhIHByb2Nlc3NpbmcgZnVuY3Rpb25zIG9mIHRoZSBtbHIgcGFja2FnZSwgeW91IGNhbiBzcGVjaWZ5IHRoZQp0YXJnZXQgKHByZWRpY3RlZCkgdmFyaWFibGUgaW4gdGhlIGRhdGEgc2V0LiBUaGlzIHdpbGwgcHJldmVudCB0aGUgZGF0YQpwcm9jZXNzaW5nIGZ1bmN0aW9ucyBmcm9tIG1vZGlmeWluZyB0aGF0IHZhcmlhYmxlLgoKYGBge3IsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CmNvbWJpbmVkIDwtIG5vcm1hbGl6ZUZlYXR1cmVzKGNvbWJpbmVkLCB0YXJnZXQgPSAiU3Vydml2ZWQiKQoKc3VtbWFyaXplQ29sdW1ucyhjb21iaW5lZCkgJT4lCiAga2FibGUoZGlnaXRzID0gMikKYGBgCgoKIyBDb252ZXJ0IGZhY3RvcnMgdG8gZHVtbXkgdmFyaWFibGVzCkFsbCBmYWN0b3JzIG11c3QgYmUgZXhwYW5kZWQgaW50byBudW1lcmljIGR1bW15IGNvbHVtbnMgKG9uZS1ob3QgZW5jb2RpbmcpLiBUaGUgCk1MUiBwYWNrYWdlIHdpbGwgd2FybiB5b3UgaWYgeW91IGhhdmVuJ3QgY29tcGxldGVkIHRoaXMgc3RlcC4gQWZ0ZXIgY29udmVyc2lvbiwKbm90ZSB0aGF0IFBjbGFzcyBub3cgaGFzIHRocmVlIGZpZWxkczogUGNsYXNzLjEtMy4gRWFjaCBvbmUgaXMgZmlsbGVkIHdpdGggMCBvcgoxIGRlcGVuZGluZyBvbiBjbGFzcy4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQpjb21iaW5lZCA8LSBjcmVhdGVEdW1teUZlYXR1cmVzKAogIGNvbWJpbmVkLCB0YXJnZXQgPSAiU3Vydml2ZWQiLAogIGNvbHMgPSBjKAogICAgIlBjbGFzcyIsCiAgICAiU2V4IiwKICAgICJFbWJhcmtlZCIKICApCikKCnN1bW1hcml6ZUNvbHVtbnMoY29tYmluZWQpICU+JQogIGthYmxlKGRpZ2l0cyA9IDIpCmBgYApXZSBhcmUgZG9uZSBwcm9jZXNzaW5nIHRoZSBpbnB1dCBkYXRhLiBXZSBuZWVkIHRvIHNwbGl0IHRoZSBkYXRhIGZyYW1lIGJhY2sgaW50bwp0cmFpbiBhbmQgdGVzdCBkYXRhIGZyYW1lcy4gQWdhaW4gbm90ZSB0aGF0IGEgbG90IG1vcmUgY291bGQgYmUgZG9uZSwgYnV0IHRoZSAKcG9pbnQgb2YgdGhpcyBrZXJuZWwgaXMgdG8gc2hvdyBob3cgdG8gcGVyZm9ybSBzb21lIHRhc2tzIHdpdGggTUxSLgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KdHJhaW4gPC0gY29tYmluZWQgJT4lCiAgZmlsdGVyKGRhdGFzZXQgPT0gInRyYWluIikgJT4lCiAgc2VsZWN0KC1kYXRhc2V0KQoKdGVzdCA8LSBjb21iaW5lZCAlPiUKICBmaWx0ZXIoZGF0YXNldCA9PSAidGVzdCIpICU+JQogIHNlbGVjdCgtZGF0YXNldCkKYGBgCiMgRml0dGluZyBYR0Jvb3N0ClhnYm9vc3QgaXMgYW4gYWxnb3JpdGhtIGluIHRoZSBkZWNpc2lvbiB0cmVlIGZhbWlseS4gVGhlIGZpcnN0IHN0ZXAgaXMgdG8gY3JlYXRlCmEgdGFzaywgd2hpY2ggaXMganVzdCBhbm90aGVyIHRlcm0gZm9yIGRhdGEgc2V0LiBDcmVhdGUgb25lIGZvciBib3RoIHRoZSB0cmFpbiAKYW5kIHRlc3QgZGF0YSBzZXRzLiBUaGUgdGFyZ2V0IHNheXMgd2hpY2ggY29sdW1uIGlzIHRoZSBvbmUgdG8gcHJlZGljdC4gRXZlcnkKb3RoZXIgY29sdW1uIGlzIGFzc3VtZWQgdG8gYmUgYW4gZXhwbGFuYXRvcnkgZmVhdHVyZS4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQp0cmFpblRhc2sgPC0gbWFrZUNsYXNzaWZUYXNrKGRhdGEgPSB0cmFpbiwgdGFyZ2V0ID0gIlN1cnZpdmVkIiwgcG9zaXRpdmUgPSAxKQp0ZXN0VGFzayA8LSBtYWtlQ2xhc3NpZlRhc2soZGF0YSA9IHRlc3QsIHRhcmdldCA9ICJTdXJ2aXZlZCIpCmBgYAoKTm90ZTogdGhlIG1sciBwcm9jZXNzaW5nIGZ1bmN0aW9ucyB1c2VkIGFib3ZlIGFsc28gd29yayBvbiB0aGVzZSB0YXNrIG9iamVjdHMuCklmIHVzZWQsIHlvdSBkb24ndCBoYXZlIHRvIHNwZWNpZnkgdGhlIHRhcmdldCBjb2x1bW4gc2luY2UgdGhhdCBpbmZvcm1hdGlvbiBpcwpjb250YWluZWQgaW4gdGhlIHRhc2sgb2JqZWN0LgoKTm93IGNyZWF0ZSBhIGxlYXJuZXIgYW5kIGEgbW9kZWwuIEEgbGVhcm5lciBzcGVjaWZpZXMgYW4gYWxnb3JpdGhtIHdoaWxlIGEgbW9kZWwKcGFpcnMgaXQgd2l0aCBhIHRhc2sgKGRhdGEgc2V0KS4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQpzZXQuc2VlZCgxKQojIENyZWF0ZSBhbiB4Z2Jvb3N0IGxlYXJuZXIgdGhhdCBpcyBjbGFzc2lmaWNhdGlvbiBiYXNlZCBhbmQgb3V0cHV0cwojIGxhYmVscyAoYXMgb3Bwb3NlZCB0byBwcm9iYWJpbGl0aWVzKQp4Z2JfbGVhcm5lciA8LSBtYWtlTGVhcm5lcigKICAiY2xhc3NpZi54Z2Jvb3N0IiwKICBwcmVkaWN0LnR5cGUgPSAicmVzcG9uc2UiLAogIHBhci52YWxzID0gbGlzdCgKICAgIG9iamVjdGl2ZSA9ICJiaW5hcnk6bG9naXN0aWMiLAogICAgZXZhbF9tZXRyaWMgPSAiZXJyb3IiLAogICAgbnJvdW5kcyA9IDIwMAogICkKKQoKIyBDcmVhdGUgYSBtb2RlbAp4Z2JfbW9kZWwgPC0gdHJhaW4oeGdiX2xlYXJuZXIsIHRhc2sgPSB0cmFpblRhc2spCmBgYAoKTm93IHdlIGNhbiBtYWtlIGEgcHJlZGljdGlvbi4gVGhlIG1sciBwYWNrYWdlIGFzc3VtZXMgdGhhdCB0aGUgIlN1cnZpdmVkIiBjb2x1bW4KaW4gdGhlIHRlc3QgZGF0YSBzZXQgaGFzIHRoZSBjb3JyZWN0IGFuc3dlcnMgaW4gaXQuIEl0IHBsYWNlcyB0aGVzZSBpbnRvIHRoZQoidHJ1dGgiIGNvbHVtbi4gSW4gb3VyIGNhc2UsIHRoZXkgYXJlIGFsbCB6ZXJvcy4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQpyZXN1bHQgPC0gcHJlZGljdCh4Z2JfbW9kZWwsIHRlc3RUYXNrKQoKaGVhZChyZXN1bHQkZGF0YSkgJT4lCiAga2FibGUoKQpgYGAKCkNyZWF0ZSBhIHN1Ym1pc3Npb24gZmlsZSBmb3IgS2FnZ2xlLgoKYGBge3IsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CnByZWRpY3Rpb24gPC0gcmVzdWx0JGRhdGEgJT4lCiAgc2VsZWN0KFBhc3NlbmdlcklEID0gaWQsIFN1cnZpdmVkID0gcmVzcG9uc2UpICU+JQogICMgUHV0IGJhY2sgdGhlIG9yaWdpbmFsIHBhc3NlbmdlciBJRHMuIE5vIHNvcnRpbmcgaGFzIGhhcHBlbmVkLCBzbwogICMgZXZlcnl0aGluZyBzdGlsbCBtYXRjaGVzIHVwLgogIG11dGF0ZShQYXNzZW5nZXJJRCA9IHRlc3Rfb3JpZyRQYXNzZW5nZXJJZCkKCiN3cml0ZV9jc3YocHJlZGljdGlvbiwgImluaXRpYWxfcHJlZGljdGlvbi5jc3YiKQpgYGAKClRoaXMgc2NvcmVkIGEgLjczMjA2LCBhbmQgcmFua2VkIGF0IDY3ODUgb24gdGhlIGxlYWRlciBib2FyZCBvdXQgb2YgNzU2Ny4KUHJldHR5IG11Y2ggdGhlIGJvdHRvbTsgaG93ZXZlciwgd2UgYWNoaWV2ZWQgdGhhdCByZXN1bHQgd2l0aCBhIHRyaXZpYWwgYW1vdW50Cm9mIGVmZm9ydC4gV2UgZGlkbid0IGV2ZW4gdHVuZSBvdXIgbW9kZWwncyBoeXBlci1wYXJhbWV0ZXJzLgoKIyBIeXBlci1wYXJhbWV0ZXIgVHVuaW5nCgpXZSBjYW4gaW1wcm92ZSBvbiB0aGUgYWJvdmUgcGVyZm9ybWFuY2UgYnkgdHVuaW5nIG91ciBoeXBlci1wYXJhbWV0ZXJzLiBZb3UgY2FuCnZpZXcgYWxsIHRoZSBwYXJhbWV0ZXJzIG9mIHRoZSB4Z2Jvb3N0IGFsZ29yaXRobSB1c2luZyB0aGUgbWxyIHBhY2thZ2UuIEEgc2ltcGxlCmFwcHJvYWNoIHdvdWxkIGJlIHRvIHBsYXkgd2l0aCB0aGVzZSBwYXJhbWV0ZXJzIG1hbnVhbGx5IHRvIGltcHJvdmUgcGVyZm9ybWFuY2UuCgpUbyByZWFkIHVwIG9uIHRoZSBwYXJhbWV0ZXJzLCBzZWUgaGVyZTogIApbaHR0cDovL3hnYm9vc3QucmVhZHRoZWRvY3MuaW8vZW4vbGF0ZXN0L3BhcmFtZXRlci5odG1sXShodHRwOi8veGdib29zdC5yZWFkdGhlZG9jcy5pby9lbi9sYXRlc3QvcGFyYW1ldGVyLmh0bWwpCgpgYGB7ciwgbWVzc2FnZT1GQUxTRSwgd2FybmluZz1GQUxTRX0KIyBUbyBzZWUgYWxsIHRoZSBwYXJhbWV0ZXJzIG9mIHRoZSB4Z2Jvb3N0IGNsYXNzaWZpZXIKZ2V0UGFyYW1TZXQoImNsYXNzaWYueGdib29zdCIpCmBgYAoKVGhlIHN1bW1hcnkgdGFibGUgYWJvdmUgYWxzbyBsaXN0cyB3aGljaCBwYXJhbWV0ZXJzIGNhbiBiZSB0dW5lZCBhdXRvbWF0aWNhbGx5CmluIHRoZSAiVHVuYWJsZSIgY29sdW1uLiBUaGUgZm9sbG93aW5nIGNvZGUgd2lsbCBwZXJmb3JtIHRoaXMgYXV0b21hdGVkIHR1bmluZy4KVGhlIGZpcnN0IHN0ZXAgaXMgdG8gZGVmaW5lIHdoaWNoIHRlcm1zIHRvIHR1bmUvb3B0aW1pemUuCgpPbmUgbm90ZSBhYm91dCBzZWFyY2ggc3BhY2U6IHdoZW4gZHJhd2luZyBmcm9tIGEgdW5pZm9ybS9yYW5kb20gZGlzdHJpYnV0aW9uIApiZXR3ZWVuIGZyb20gLjAxIHRvIDEgZm9yIGxhbWJkYSAoZm9yIGV4YW1wbGUpLCB5b3Ugd29uJ3QgYWRlcXVhdGVseSBzZWFyY2ggdGhlCnNwYWNlIG9uIHRoZSBsb3cgZW5kIG9mIHRoZSByYW5nZSAoZS5nLiAuMDEgLSAuMDIpLiBZb3UgY2FuIGluY3JlYXNlIHRoZSBudW1iZXIKb2Ygc2FtcGxlcyB0YWtlbiBpbiB0aGlzIHJhbmdlIHVzaW5nIHRoZSBgdHJhbnNmb2AgKHRyYW5zZm9ybWF0aW9uKSBhcmd1bWVudCBpbgpgbWFrZVBhcmFtU2V0YC4gSSBoYXZlIGRvbmUgdGhpcyBpbiB0aGUgY29kZSBiZWxvdy4gTW9yZSBpbmZvIGFmdGVyIHRoZSBjb2RlCmJsb2NrLgoKYGBge3IsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CnhnYl9wYXJhbXMgPC0gbWFrZVBhcmFtU2V0KAogICMgVGhlIG51bWJlciBvZiB0cmVlcyBpbiB0aGUgbW9kZWwgKGVhY2ggb25lIGJ1aWx0IHNlcXVlbnRpYWxseSkKICBtYWtlSW50ZWdlclBhcmFtKCJucm91bmRzIiwgbG93ZXIgPSAxMDAsIHVwcGVyID0gNTAwKSwKICAjIG51bWJlciBvZiBzcGxpdHMgaW4gZWFjaCB0cmVlCiAgbWFrZUludGVnZXJQYXJhbSgibWF4X2RlcHRoIiwgbG93ZXIgPSAxLCB1cHBlciA9IDEwKSwKICAjICJzaHJpbmthZ2UiIC0gcHJldmVudHMgb3ZlcmZpdHRpbmcKICBtYWtlTnVtZXJpY1BhcmFtKCJldGEiLCBsb3dlciA9IC4xLCB1cHBlciA9IC41KSwKICAjIEwyIHJlZ3VsYXJpemF0aW9uIC0gcHJldmVudHMgb3ZlcmZpdHRpbmcKICBtYWtlTnVtZXJpY1BhcmFtKCJsYW1iZGEiLCBsb3dlciA9IC0xLCB1cHBlciA9IDAsIHRyYWZvID0gZnVuY3Rpb24oeCkgMTBeeCkKKQpgYGAKCkZvciBsYW1iZGEsIGEgcmFuZG9tIHZhbHVlIHdpbGwgYmUgY2hvc2VuICh1bmlmb3JtbHkpIGJldHdlZW4gLTEgYW5kIDAuIFRoYXQKdmFsdWUgaXMgdGhlbiB0cmFuc2Zvcm1lZCB0byB0aGUgcGFyYW1ldGVyIHVzaW5nIDEwIF4geCwgbWVhbmluZyB0aGF0IHRoZQpwYXJhbWV0ZXIgcmFuZ2UgaXMgMTBeLTEgKC4xKSB0byAxMF4wICgxKS4gVGhpcyB3aWxsIGluY3JlYXNlIHRoZSBudW1iZXIgb2YKc2FtcGxlcyB0YWtlbiBmb3Igc21hbGwgdmFsdWVzIG9mIHRoZSBwYXJhbWV0ZXIsIGFuZCBpcyBlZmZlY3RpdmVseSBzYW1wbGluZwpvbiB0aGUgbG9nIHNjYWxlIG9mIHRoZSByYW5nZS4KClRoZSBuZXh0IHN0ZXAgaXMgdG8gZGVmaW5lIGhvdyB3ZSB3aWxsIHNlYXJjaCAocmFuZG9tLCBncmlkLCBldGMuKS4gV2Ugd2lsbCBkbwpyYW5kb20gc2VhcmNoLiBPbiBteSBsYXB0b3AsIEkgcmFuIDUwIGl0ZXJhdGlvbnMgaW4gPCAxIG1pbnV0ZSwgYnV0IGl0IHRha2VzCmxvbmdlciB0aGFuIDIwIG1pbnV0ZXMgaW4gdGhlIEthZ2dsZSBrZXJuZWwsIHNvIEkgaGF2ZSByZWR1Y2VkIGl0LiBUaGUgcmVzdApvZiB0aGUgc2NyaXB0IChhbmQgd2hhdCBJIHJlcG9ydCBhcyBmaW5hbCBzY29yZSksIGFzc3VtZXMgNTAgaXRlcmF0aW9ucy4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQpjb250cm9sIDwtIG1ha2VUdW5lQ29udHJvbFJhbmRvbShtYXhpdCA9IDEpCmBgYAoKVGhlIGxhc3Qgc2V0dXAgc3RlcCBpcyB0byBkZWZpbmUgaG93IHdlIHdpbGwgZXZhbHVhdGUgdGhlIGRpZmZlcmVudCBzZXRzIG9mIApyYW5kb21seS1jaG9zZW4gcGFyYW1ldGVycy4gSGVyZSwgSSBhbSBnb2luZyB0byB1c2UgNC1mb2xkIGNyb3NzLXZhbGlkYXRpb24uIEluIAp0aGlzIGFwcHJvYWNoLCBvdXIgdHJhaW5pbmcgZGF0YSBpcyBzcGxpdCBpbnRvIDQgZXF1YWwgZ3JvdXBzLiBUaGUgbW9kZWwgaXMgCnRyYWluZWQgb24gMyBvZiB0aGUgZm91ciBncm91cHMgYW5kIGV2YWx1YXRlZCBvbiB0aGUgNHRoLiBUaGlzIHByb2Nlc3MgcmVwZWF0cwp1bnRpbCBlYWNoIG9mIHRoZSBmb3VyIGdyb3VwcyBoYXMgYmVlbiB1c2VkIGFzIHRoZSB2YWxpZGF0aW9uIHNldC4gUGVyZm9ybWFuY2UKbWVhc3VyZXMgYXJlIHRoZW4gYXZlcmFnZWQgaW50byBhIGZpbmFsIHNjb3JlLgoKYGBge3IsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CiMgQ3JlYXRlIGEgZGVzY3JpcHRpb24gb2YgdGhlIHJlc2FtcGxpbmcgcGxhbgpyZXNhbXBsZV9kZXNjIDwtIG1ha2VSZXNhbXBsZURlc2MoIkNWIiwgaXRlcnMgPSA0KQpgYGAKCldpdGggYWxsIG9mIG91ciBzZXR0aW5ncyBjb21wbGV0ZSwgd2UgcGVyZm9ybSB0aGUgdHVuaW5nLgoKYGBge3IsIG1lc3NhZ2U9RkFMU0UsIHdhcm5pbmc9RkFMU0V9CnR1bmVkX3BhcmFtcyA8LSB0dW5lUGFyYW1zKAogIGxlYXJuZXIgPSB4Z2JfbGVhcm5lciwKICB0YXNrID0gdHJhaW5UYXNrLAogIHJlc2FtcGxpbmcgPSByZXNhbXBsZV9kZXNjLAogIHBhci5zZXQgPSB4Z2JfcGFyYW1zLAogIGNvbnRyb2wgPSBjb250cm9sCikKYGBgCgpBZnRlciB0dW5pbmcsIHdlIGNhbiBjcmVhdGUgYSBuZXcgeGdib29zdCBtb2RlbCB1c2luZyB0aGUgcGFyYW1ldGVycyB0aGF0CmdhdmUgdGhlIGJlc3QgcmVzdWx0cy4gV2UgdGhlbiB0cmFpbiBhbmQgcHJlZGljdCB1c2luZyB0aGF0IG5ldyBtb2RlbC4KCmBgYHtyLCBtZXNzYWdlPUZBTFNFLCB3YXJuaW5nPUZBTFNFfQojIENyZWF0ZSBhIG5ldyBtb2RlbCB1c2luZyB0dW5lZCBoeXBlcnBhcmFtZXRlcnMKeGdiX3R1bmVkX2xlYXJuZXIgPC0gc2V0SHlwZXJQYXJzKAogIGxlYXJuZXIgPSB4Z2JfbGVhcm5lciwKICBwYXIudmFscyA9IHR1bmVkX3BhcmFtcyR4CikKCiMgUmUtdHJhaW4gcGFyYW1ldGVycyB1c2luZyB0dW5lZCBoeXBlcnBhcmFtZXRlcnMgKGFuZCBmdWxsIHRyYWluaW5nIHNldCkKeGdiX21vZGVsIDwtIHRyYWluKHhnYl90dW5lZF9sZWFybmVyLCB0cmFpblRhc2spCgojIE1ha2UgYSBuZXcgcHJlZGljdGlvbgpyZXN1bHQgPC0gcHJlZGljdCh4Z2JfbW9kZWwsIHRlc3RUYXNrKQpwcmVkaWN0aW9uIDwtIHJlc3VsdCRkYXRhICU+JQogIHNlbGVjdChQYXNzZW5nZXJJRCA9IGlkLCBTdXJ2aXZlZCA9IHJlc3BvbnNlKSAlPiUKICAjIFB1dCBiYWNrIHRoZSBvcmlnaW5hbCBwYXNzZW5nZXIgSURzLiBObyBzb3J0aW5nIGhhcyBoYXBwZW5lZCwgc28KICAjIGV2ZXJ5dGhpbmcgc3RpbGwgbWF0Y2hlcyB1cC4KICBtdXRhdGUoUGFzc2VuZ2VySUQgPSB0ZXN0X29yaWckUGFzc2VuZ2VySWQpCgojd3JpdGVfY3N2KHByZWRpY3Rpb24sICJmaW5hbF9wcmVkaWN0aW9uLmNzdiIpCmBgYAoKVHVuaW5nIHRoZSBoeXBlci1wYXJhbWV0ZXJzIGluY3JlYXNlZCB0aGUgc2NvcmUgdG8gLjc2MDc3IHdpdGggYSByYW5rIG9mIDU5NzMgb3V0Cm9mIDc0NzIuIEZ1cnRoZXIgaW1wcm92ZW1lbnRzIGNvdWxkIGJlIGdhaW5lZCBieSBkb2luZyBtb3JlIHJlZmluZWQgaW1wdXRhdGlvbiwKZmVhdHVyZSBjcmVhdGlvbiwgYmV0dGVyIHR1bmluZywgZXRjLgoKIyBYR0Jvb3N0IHR1dG9yaWFsIHsudGFic2V0fQoKIyMgV2h5IGlzIGl0IHNvIGdvb2QgPwpYR0Jvb3N0IChFeHRyZW1lIEdyYWRpZW50IEJvb3N0aW5nKSBpcyBhbiBvcHRpbWl6ZWQgZGlzdHJpYnV0ZWQgZ3JhZGllbnQgYm9vc3RpbmcgbGlicmFyeS4gCgorICoqUGFyYWxsZWwgQ29tcHV0aW5nOioqIEl0IGlzIGVuYWJsZWQgd2l0aCBwYXJhbGxlbCBwcm9jZXNzaW5nICh1c2luZyBPcGVuTVApOyBpLmUuLCB3aGVuIHlvdSBydW4geGdib29zdCwgYnkgZGVmYXVsdCwgaXQgd291bGQgdXNlIGFsbCB0aGUgY29yZXMgb2YgeW91ciBsYXB0b3AvbWFjaGluZS4KCisgKipSZWd1bGFyaXphdGlvbjoqKiBJIGJlbGlldmUgdGhpcyBpcyB0aGUgYmlnZ2VzdCBhZHZhbnRhZ2Ugb2YgeGdib29zdC4gR0JNIGhhcyBubyBwcm92aXNpb24gZm9yIHJlZ3VsYXJpemF0aW9uLiBSZWd1bGFyaXphdGlvbiBpcyBhIHRlY2huaXF1ZSB1c2VkIHRvIGF2b2lkIG92ZXJmaXR0aW5nIGluIGxpbmVhciBhbmQgdHJlZS1iYXNlZCBtb2RlbHMuCgorICoqRW5hYmxlZCBDcm9zcyBWYWxpZGF0aW9uOioqIEluIFIsIHdlIHVzdWFsbHkgdXNlIGV4dGVybmFsIHBhY2thZ2VzIHN1Y2ggYXMgY2FyZXQgYW5kIG1sciB0byBvYnRhaW4gQ1YgcmVzdWx0cy4gQnV0LCB4Z2Jvb3N0IGlzIGVuYWJsZWQgd2l0aCBpbnRlcm5hbCBDViBmdW5jdGlvbiAod2UnbGwgc2VlIGJlbG93KS4KCisgKipNaXNzaW5nIFZhbHVlczoqKiBYR0Jvb3N0IGlzIGRlc2lnbmVkIHRvIGhhbmRsZSBtaXNzaW5nIHZhbHVlcyBpbnRlcm5hbGx5LiBUaGUgbWlzc2luZyB2YWx1ZXMgYXJlIHRyZWF0ZWQgaW4gc3VjaCBhIG1hbm5lciB0aGF0IGlmIHRoZXJlIGV4aXN0cyBhbnkgdHJlbmQgaW4gbWlzc2luZyB2YWx1ZXMsIGl0IGlzIGNhcHR1cmVkIGJ5IHRoZSBtb2RlbC4KCisgKipGbGV4aWJpbGl0eToqKiBJbiBhZGRpdGlvbiB0byByZWdyZXNzaW9uLCBjbGFzc2lmaWNhdGlvbiwgYW5kIHJhbmtpbmcgcHJvYmxlbXMsIGl0IHN1cHBvcnRzIHVzZXItZGVmaW5lZCBvYmplY3RpdmUgZnVuY3Rpb25zIGFsc28uIEFuIG9iamVjdGl2ZSBmdW5jdGlvbiBpcyB1c2VkIHRvIG1lYXN1cmUgdGhlIHBlcmZvcm1hbmNlIG9mIHRoZSBtb2RlbCBnaXZlbiBhIGNlcnRhaW4gc2V0IG9mIHBhcmFtZXRlcnMuIEZ1cnRoZXJtb3JlLCBpdCBzdXBwb3J0cyB1c2VyIGRlZmluZWQgZXZhbHVhdGlvbiBtZXRyaWNzIGFzIHdlbGwuCgorICoqQXZhaWxhYmlsaXR5OioqIEN1cnJlbnRseSwgaXQgaXMgYXZhaWxhYmxlIGZvciBwcm9ncmFtbWluZyBsYW5ndWFnZXMgc3VjaCBhcyBSLCBQeXRob24sIEphdmEsIEp1bGlhLCBhbmQgU2NhbGEuCgorICoqU2F2ZSBhbmQgUmVsb2FkOioqIFhHQm9vc3QgZ2l2ZXMgdXMgYSBmZWF0dXJlIHRvIHNhdmUgb3VyIGRhdGEgbWF0cml4IGFuZCBtb2RlbCBhbmQgcmVsb2FkIGl0IGxhdGVyLiBTdXBwb3NlLCB3ZSBoYXZlIGEgbGFyZ2UgZGF0YSBzZXQsIHdlIGNhbiBzaW1wbHkgc2F2ZSB0aGUgbW9kZWwgYW5kIHVzZSBpdCBpbiBmdXR1cmUgaW5zdGVhZCBvZiB3YXN0aW5nIHRpbWUgcmVkb2luZyB0aGUgY29tcHV0YXRpb24uCgorICoqVHJlZSBQcnVuaW5nOioqIFVubGlrZSBHQk0sIHdoZXJlIHRyZWUgcHJ1bmluZyBzdG9wcyBvbmNlIGEgbmVnYXRpdmUgbG9zcyBpcyBlbmNvdW50ZXJlZCwgWEdCb29zdCBncm93cyB0aGUgdHJlZSB1cHRvIG1heF9kZXB0aCBhbmQgdGhlbiBwcnVuZSBiYWNrd2FyZCB1bnRpbCB0aGUgaW1wcm92ZW1lbnQgaW4gbG9zcyBmdW5jdGlvbiBpcyBiZWxvdyBhIHRocmVzaG9sZC4KCiMjIEhvdyBkb2VzIFhHQm9vc3Qgd29yawpYR0Jvb3N0IGJlbG9uZ3MgdG8gYSBmYW1pbHkgb2YgYm9vc3RpbmcgYWxnb3JpdGhtcyB0aGF0IGNvbnZlcnQgd2VhayBsZWFybmVycyBpbnRvIHN0cm9uZyBsZWFybmVycy4gQSB3ZWFrIGxlYXJuZXIgaXMgb25lIHdoaWNoIGlzIHNsaWdodGx5IGJldHRlciB0aGFuIHJhbmRvbSBndWVzc2luZy4gTGV0J3MgdW5kZXJzdGFuZCBib29zdGluZyBmaXJzdCAoaW4gZ2VuZXJhbCkuCgoqKkJvb3N0aW5nIGlzIGEgc2VxdWVudGlhbCBwcm9jZXNzOyoqIGkuZS4sIHRyZWVzIGFyZSBncm93biB1c2luZyB0aGUgaW5mb3JtYXRpb24gZnJvbSBhIHByZXZpb3VzbHkgZ3Jvd24gdHJlZSBvbmUgYWZ0ZXIgdGhlIG90aGVyLiBUaGlzIHByb2Nlc3Mgc2xvd2x5IGxlYXJucyBmcm9tIGRhdGEgYW5kIHRyaWVzIHRvIGltcHJvdmUgaXRzIHByZWRpY3Rpb24gaW4gc3Vic2VxdWVudCBpdGVyYXRpb25zLiBMZXQncyBsb29rIGF0IGEgY2xhc3NpYyBjbGFzc2lmaWNhdGlvbiBleGFtcGxlOgoKWzxpbWcgc3JjPSJ4Z2Jvb3N0X2ltZzEucG5nIj5dKCkKCkZvdXIgY2xhc3NpZmllcnMgKGluIDQgYm94ZXMpLCBzaG93biBhYm92ZSwgYXJlIHRyeWluZyBoYXJkIHRvIGNsYXNzaWZ5ICsgYW5kIC0gY2xhc3NlcyBhcyBob21vZ2VuZW91c2x5IGFzIHBvc3NpYmxlLiBMZXQncyB1bmRlcnN0YW5kIHRoaXMgcGljdHVyZSB3ZWxsLgoKKyAqKkJveCAxOioqIFRoZSBmaXJzdCBjbGFzc2lmaWVyIGNyZWF0ZXMgYSB2ZXJ0aWNhbCBsaW5lIChzcGxpdCkgYXQgRDEuIEl0IHNheXMgYW55dGhpbmcgdG8gdGhlIGxlZnQgb2YgRDEgaXMgKyBhbmQgYW55dGhpbmcgdG8gdGhlIHJpZ2h0IG9mIEQxIGlzIC0uIEhvd2V2ZXIsIHRoaXMgY2xhc3NpZmllciBtaXNjbGFzc2lmaWVzIHRocmVlICsgcG9pbnRzLgoKKyAqKkJveCAyOioqIFRoZSBuZXh0IGNsYXNzaWZpZXIgc2F5cyBkb24ndCB3b3JyeSBJIHdpbGwgY29ycmVjdCB5b3VyIG1pc3Rha2VzLiBUaGVyZWZvcmUsIGl0IGdpdmVzIG1vcmUgd2VpZ2h0IHRvIHRoZSB0aHJlZSArIG1pc2NsYXNzaWZpZWQgcG9pbnRzIChzZWUgYmlnZ2VyIHNpemUgb2YgKykgYW5kIGNyZWF0ZXMgYSB2ZXJ0aWNhbCBsaW5lIGF0IEQyLiBBZ2FpbiBpdCBzYXlzLCBhbnl0aGluZyB0byByaWdodCBvZiBEMiBpcyAtIGFuZCBsZWZ0IGlzICsuICBTdGlsbCwgaXQgbWFrZXMgbWlzdGFrZXMgYnkgaW5jb3JyZWN0bHkgY2xhc3NpZnlpbmcgdGhyZWUgLSBwb2ludHMuCgorICoqQm94IDM6KiogVGhlIG5leHQgY2xhc3NpZmllciBjb250aW51ZXMgdG8gYmVzdG93IHN1cHBvcnQuIEFnYWluLCBpdCBnaXZlcyBtb3JlIHdlaWdodCB0byB0aGUgdGhyZWUgLSBtaXNjbGFzc2lmaWVkIHBvaW50cyBhbmQgY3JlYXRlcyBhIGhvcml6b250YWwgbGluZSBhdCBEMy4gU3RpbGwsIHRoaXMgY2xhc3NpZmllciBmYWlscyB0byBjbGFzc2lmeSB0aGUgcG9pbnRzIChpbiBjaXJjbGUpIGNvcnJlY3RseS4KUmVtZW1iZXIgdGhhdCBlYWNoIG9mIHRoZXNlIGNsYXNzaWZpZXJzIGhhcyBhIG1pc2NsYXNzaWZpY2F0aW9uIGVycm9yIGFzc29jaWF0ZWQgd2l0aCB0aGVtLgoKQm94ZXMgMSwyLCBhbmQgMyBhcmUgd2VhayBjbGFzc2lmaWVycy4gVGhlc2UgY2xhc3NpZmllcnMgd2lsbCBub3cgYmUgdXNlZCB0byBjcmVhdGUgYSBzdHJvbmcgY2xhc3NpZmllciBCb3ggNC4KCisgKipCb3ggNDoqKiBJdCBpcyBhIHdlaWdodGVkIGNvbWJpbmF0aW9uIG9mIHRoZSB3ZWFrIGNsYXNzaWZpZXJzLiBBcyB5b3UgY2FuIHNlZSwgaXQgZG9lcyBnb29kIGpvYiBhdCBjbGFzc2lmeWluZyBhbGwgdGhlIHBvaW50cyBjb3JyZWN0bHkuCgpUaGF0J3MgdGhlIGJhc2ljIGlkZWEgYmVoaW5kIGJvb3N0aW5nIGFsZ29yaXRobXMuIFRoZSB2ZXJ5IG5leHQgbW9kZWwgY2FwaXRhbGl6ZXMgb24gdGhlIG1pc2NsYXNzaWZpY2F0aW9uL2Vycm9yIG9mIHByZXZpb3VzIG1vZGVsIGFuZCB0cmllcyB0byByZWR1Y2UgaXQuIE5vdywgbGV0J3MgY29tZSB0byBYR0Jvb3N0LgoKQXMgd2Uga25vdywgWEdCb29zdCBjYW4gdXNlZCB0byBzb2x2ZSBib3RoIHJlZ3Jlc3Npb24gYW5kIGNsYXNzaWZpY2F0aW9uIHByb2JsZW1zLiBJdCBpcyBlbmFibGVkIHdpdGggc2VwYXJhdGUgbWV0aG9kcyB0byBzb2x2ZSByZXNwZWN0aXZlIHByb2JsZW1zLiBMZXQncyBzZWU6CgoqKkNsYXNzaWZpY2F0aW9uIFByb2JsZW1zOioqIFRvIHNvbHZlIHN1Y2ggcHJvYmxlbXMsIGl0IHVzZXMgYm9vc3RlciA9IGdidHJlZSBwYXJhbWV0ZXI7IGkuZS4sIGEgdHJlZSBpcyBncm93biBvbmUgYWZ0ZXIgb3RoZXIgYW5kIGF0dGVtcHRzIHRvIHJlZHVjZSBtaXNjbGFzc2lmaWNhdGlvbiByYXRlIGluIHN1YnNlcXVlbnQgaXRlcmF0aW9ucy4gSW4gdGhpcywgdGhlIG5leHQgdHJlZSBpcyBidWlsdCBieSBnaXZpbmcgYSBoaWdoZXIgd2VpZ2h0IHRvIG1pc2NsYXNzaWZpZWQgcG9pbnRzIGJ5IHRoZSBwcmV2aW91cyB0cmVlIChhcyBleHBsYWluZWQgYWJvdmUpLgoKKipSZWdyZXNzaW9uIFByb2JsZW1zOioqIFRvIHNvbHZlIHN1Y2ggcHJvYmxlbXMsIHdlIGhhdmUgdHdvIG1ldGhvZHM6IGJvb3N0ZXIgPSBnYnRyZWUgYW5kIGJvb3N0ZXIgPSBnYmxpbmVhci4gWW91IGFscmVhZHkga25vdyBnYnRyZWUuIEluIGdibGluZWFyLCBpdCBidWlsZHMgZ2VuZXJhbGl6ZWQgbGluZWFyIG1vZGVsIGFuZCBvcHRpbWl6ZXMgaXQgdXNpbmcgcmVndWxhcml6YXRpb24gKEwxLEwyKSBhbmQgZ3JhZGllbnQgZGVzY2VudC4gSW4gdGhpcywgdGhlIHN1YnNlcXVlbnQgbW9kZWxzIGFyZSBidWlsdCBvbiByZXNpZHVhbHMgKGFjdHVhbCAtIHByZWRpY3RlZCkgZ2VuZXJhdGVkIGJ5IHByZXZpb3VzIGl0ZXJhdGlvbnMuIEFyZSB5b3Ugd29uZGVyaW5nIHdoYXQgaXMgZ3JhZGllbnQgZGVzY2VudD8gVW5kZXJzdGFuZGluZyBncmFkaWVudCBkZXNjZW50IHJlcXVpcmVzIG1hdGgsIGhvd2V2ZXIsIGxldCBtZSB0cnkgYW5kIGV4cGxhaW4gaXQgaW4gc2ltcGxlIHdvcmRzOgoKKyAqKkdyYWRpZW50IERlc2NlbnQ6KiogSXQgaXMgYSBtZXRob2Qgd2hpY2ggY29tcHJpc2VzIGEgdmVjdG9yIG9mIHdlaWdodHMgKG9yIGNvZWZmaWNpZW50cykgd2hlcmUgd2UgY2FsY3VsYXRlIHRoZWlyIHBhcnRpYWwgZGVyaXZhdGl2ZSB3aXRoIHJlc3BlY3RpdmUgdG8gemVyby4gVGhlIG1vdGl2ZSBiZWhpbmQgY2FsY3VsYXRpbmcgdGhlaXIgcGFydGlhbCBkZXJpdmF0aXZlIGlzIHRvIGZpbmQgdGhlIGxvY2FsIG1pbmltYSBvZiB0aGUgbG9zcyBmdW5jdGlvbiAoUlNTKSwgd2hpY2ggaXMgY29udmV4IGluIG5hdHVyZS4gSW4gc2ltcGxlIHdvcmRzLCBncmFkaWVudCBkZXNjZW50IHRyaWVzIHRvIG9wdGltaXplIHRoZSBsb3NzIGZ1bmN0aW9uIGJ5IHR1bmluZyBkaWZmZXJlbnQgdmFsdWVzIG9mIGNvZWZmaWNpZW50cyB0byBtaW5pbWl6ZSB0aGUgZXJyb3IuCgojIyBVbmRlcnN0YW5kaW5nIFhHQm9vc3QgVHVuaW5nIFBhcmFtZXRlcnMKCkV2ZXJ5IHBhcmFtZXRlciBoYXMgYSBzaWduaWZpY2FudCByb2xlIHRvIHBsYXkgaW4gdGhlIG1vZGVsJ3MgcGVyZm9ybWFuY2UuIEJlZm9yZSBoeXBlcnR1bmluZywgbGV0J3MgZmlyc3QgdW5kZXJzdGFuZCBhYm91dCB0aGVzZSBwYXJhbWV0ZXJzIGFuZCB0aGVpciBpbXBvcnRhbmNlLiBJbiB0aGlzIGFydGljbGUsIEkndmUgb25seSBleHBsYWluZWQgdGhlIG1vc3QgZnJlcXVlbnRseSB1c2VkIGFuZCB0dW5hYmxlIHBhcmFtZXRlcnMuIFRvIGxvb2sgYXQgYWxsIHRoZSBwYXJhbWV0ZXJzLCB5b3UgY2FuIHJlZmVyIHRvIGl0cyBvZmZpY2lhbCBkb2N1bWVudGF0aW9uLgoKWEdCb29zdCBwYXJhbWV0ZXJzIGNhbiBiZSBkaXZpZGVkIGludG8gdGhyZWUgY2F0ZWdvcmllcyAoYXMgc3VnZ2VzdGVkIGJ5IGl0cyBhdXRob3JzKToKCisgKipHZW5lcmFsIFBhcmFtZXRlcnM6KiogQ29udHJvbHMgdGhlIGJvb3N0ZXIgdHlwZSBpbiB0aGUgbW9kZWwgd2hpY2ggZXZlbnR1YWxseSBkcml2ZXMgb3ZlcmFsbCBmdW5jdGlvbmluZwoKKyAqKkJvb3N0ZXIgUGFyYW1ldGVyczoqKiBDb250cm9scyB0aGUgcGVyZm9ybWFuY2Ugb2YgdGhlIHNlbGVjdGVkIGJvb3N0ZXIKCisgKipMZWFybmluZyBUYXNrIFBhcmFtZXRlcnM6KiogU2V0cyBhbmQgZXZhbHVhdGVzIHRoZSBsZWFybmluZyBwcm9jZXNzIG9mIHRoZSBib29zdGVyIGZyb20gdGhlIGdpdmVuIGRhdGEKCioqMS4gR2VuZXJhbCBQYXJhbWV0ZXJzKioKCiogQm9vc3RlcltkZWZhdWx0PWdidHJlZV0KICAgICsgU2V0cyB0aGUgYm9vc3RlciB0eXBlIChnYnRyZWUsIGdibGluZWFyIG9yIGRhcnQpIHRvIHVzZS4gRm9yIGNsYXNzaWZpY2F0aW9uIHByb2JsZW1zLCB5b3UgY2FuIHVzZSBnYnRyZWUsIGRhcnQuIEZvciByZWdyZXNzaW9uLCB5b3UgY2FuIHVzZSBhbnkuCgoqIG50aHJlYWRbZGVmYXVsdD1tYXhpbXVtIGNvcmVzIGF2YWlsYWJsZV0KICAgICsgQWN0aXZhdGVzIHBhcmFsbGVsIGNvbXB1dGF0aW9uLiBHZW5lcmFsbHksIHBlb3BsZSBkb24ndCBjaGFuZ2UgaXQgYXMgdXNpbmcgbWF4aW11bSBjb3JlcyBsZWFkcyB0byB0aGUgZmFzdGVzdCBjb21wdXRhdGlvbi4KCiogc2lsZW50W2RlZmF1bHQ9MF0KICAgICsgSWYgeW91IHNldCBpdCB0byAxLCB5b3VyIFIgY29uc29sZSB3aWxsIGdldCBmbG9vZGVkIHdpdGggcnVubmluZyBtZXNzYWdlcy4gQmV0dGVyIG5vdCB0byBjaGFuZ2UgaXQuCgoqKjIuIEJvb3N0ZXIgUGFyYW1ldGVycyoqCgpBcyBtZW50aW9uZWQgYWJvdmUsIHBhcmFtZXRlcnMgZm9yIHRyZWUgYW5kIGxpbmVhciBib29zdGVycyBhcmUgZGlmZmVyZW50LiBMZXQncyB1bmRlcnN0YW5kIGVhY2ggb25lIG9mIHRoZW06CgoqKlBhcmFtZXRlcnMgZm9yIFRyZWUgQm9vc3RlcioqCgoqIG5yb3VuZHNbZGVmYXVsdD0xMDBdCiAgICArIEl0IGNvbnRyb2xzIHRoZSBtYXhpbXVtIG51bWJlciBvZiBpdGVyYXRpb25zLiBGb3IgY2xhc3NpZmljYXRpb24sIGl0IGlzIHNpbWlsYXIgdG8gdGhlIG51bWJlciBvZiB0cmVlcyB0byBncm93LgogICAgKyBTaG91bGQgYmUgdHVuZWQgdXNpbmcgQ1YKCiogZXRhW2RlZmF1bHQ9MC4zXVtyYW5nZTogKDAsMSldCiAgICArIEl0IGNvbnRyb2xzIHRoZSBsZWFybmluZyByYXRlLCBpLmUuLCB0aGUgcmF0ZSBhdCB3aGljaCBvdXIgbW9kZWwgbGVhcm5zIHBhdHRlcm5zIGluIGRhdGEuIEFmdGVyIGV2ZXJ5IHJvdW5kLCBpdCBzaHJpbmtzIHRoZSBmZWF0dXJlIHdlaWdodHMgdG8gcmVhY2ggdGhlIGJlc3Qgb3B0aW11bS4KICAgICsgTG93ZXIgZXRhIGxlYWRzIHRvIHNsb3dlciBjb21wdXRhdGlvbi4gSXQgbXVzdCBiZSBzdXBwb3J0ZWQgYnkgaW5jcmVhc2UgaW4gbnJvdW5kcy4KICAgICsgVHlwaWNhbGx5LCBpdCBsaWVzIGJldHdlZW4gMC4wMSAtIDAuMwoKKiBnYW1tYVtkZWZhdWx0PTBdW3JhbmdlOiAoMCxJbmYpXQogICAgKyBJdCBjb250cm9scyByZWd1bGFyaXphdGlvbiAob3IgcHJldmVudHMgb3ZlcmZpdHRpbmcpLiBUaGUgb3B0aW1hbCB2YWx1ZSBvZiBnYW1tYSBkZXBlbmRzIG9uIHRoZSBkYXRhIHNldCBhbmQgb3RoZXIgcGFyYW1ldGVyIHZhbHVlcy4KICAgICsgSGlnaGVyIHRoZSB2YWx1ZSwgaGlnaGVyIHRoZSByZWd1bGFyaXphdGlvbi4gUmVndWxhcml6YXRpb24gbWVhbnMgcGVuYWxpemluZyBsYXJnZSBjb2VmZmljaWVudHMgd2hpY2ggZG9uJ3QgaW1wcm92ZSB0aGUgbW9kZWwncyBwZXJmb3JtYW5jZS4gZGVmYXVsdCA9IDAgbWVhbnMgbm8gcmVndWxhcml6YXRpb24uCiAgICArIFR1bmUgdHJpY2s6IFN0YXJ0IHdpdGggMCBhbmQgY2hlY2sgQ1YgZXJyb3IgcmF0ZS4gSWYgeW91IHNlZSB0cmFpbiBlcnJvciA+Pj4gdGVzdCBlcnJvciwgYnJpbmcgZ2FtbWEgaW50byBhY3Rpb24uIEhpZ2hlciB0aGUgZ2FtbWEsIGxvd2VyIHRoZSBkaWZmZXJlbmNlIGluIHRyYWluIGFuZCB0ZXN0IENWLiBJZiB5b3UgaGF2ZSBubyBjbHVlIHdoYXQgdmFsdWUgdG8gdXNlLCB1c2UgZ2FtbWE9NSBhbmQgc2VlIHRoZSBwZXJmb3JtYW5jZS4gUmVtZW1iZXIgdGhhdCBnYW1tYSBicmluZ3MgaW1wcm92ZW1lbnQgd2hlbiB5b3Ugd2FudCB0byB1c2Ugc2hhbGxvdyAobG93IG1heF9kZXB0aCkgdHJlZXMuCgoqIG1heF9kZXB0aFtkZWZhdWx0PTZdW3JhbmdlOiAoMCxJbmYpXQogICAgKyBJdCBjb250cm9scyB0aGUgZGVwdGggb2YgdGhlIHRyZWUuCiAgICArIExhcmdlciB0aGUgZGVwdGgsIG1vcmUgY29tcGxleCB0aGUgbW9kZWw7IGhpZ2hlciBjaGFuY2VzIG9mIG92ZXJmaXR0aW5nLiBUaGVyZSBpcyBubyBzdGFuZGFyZCB2YWx1ZSBmb3IgbWF4X2RlcHRoLiBMYXJnZXIgZGF0YSBzZXRzIHJlcXVpcmUgZGVlcCB0cmVlcyB0byBsZWFybiB0aGUgcnVsZXMgZnJvbSBkYXRhLgogICAgKyBTaG91bGQgYmUgdHVuZWQgdXNpbmcgQ1YKCiogbWluX2NoaWxkX3dlaWdodFtkZWZhdWx0PTFdW3JhbmdlOigwLEluZildCiAgICArIEluIHJlZ3Jlc3Npb24sIGl0IHJlZmVycyB0byB0aGUgbWluaW11bSBudW1iZXIgb2YgaW5zdGFuY2VzIHJlcXVpcmVkIGluIGEgY2hpbGQgbm9kZS4gSW4gY2xhc3NpZmljYXRpb24sIGlmIHRoZSBsZWFmIG5vZGUgaGFzIGEgbWluaW11bSBzdW0gb2YgaW5zdGFuY2Ugd2VpZ2h0IChjYWxjdWxhdGVkIGJ5IHNlY29uZCBvcmRlciBwYXJ0aWFsIGRlcml2YXRpdmUpIGxvd2VyIHRoYW4gbWluX2NoaWxkX3dlaWdodCwgdGhlIHRyZWUgc3BsaXR0aW5nIHN0b3BzLgogICAgKyBJbiBzaW1wbGUgd29yZHMsIGl0IGJsb2NrcyB0aGUgcG90ZW50aWFsIGZlYXR1cmUgaW50ZXJhY3Rpb25zIHRvIHByZXZlbnQgb3ZlcmZpdHRpbmcuIFNob3VsZCBiZSB0dW5lZCB1c2luZyBDVi4KCiogc3Vic2FtcGxlW2RlZmF1bHQ9MV1bcmFuZ2U6ICgwLDEpXQogICAgKyBJdCBjb250cm9scyB0aGUgbnVtYmVyIG9mIHNhbXBsZXMgKG9ic2VydmF0aW9ucykgc3VwcGxpZWQgdG8gYSB0cmVlLgogICAgKyBUeXBpY2FsbHksIGl0cyB2YWx1ZXMgbGllIGJldHdlZW4gKDAuNS0wLjgpCgoqIGNvbHNhbXBsZV9ieXRyZWVbZGVmYXVsdD0xXVtyYW5nZTogKDAsMSldCiAgICArIEl0IGNvbnRyb2wgdGhlIG51bWJlciBvZiBmZWF0dXJlcyAodmFyaWFibGVzKSBzdXBwbGllZCB0byBhIHRyZWUKICAgICtUeXBpY2FsbHksIGl0cyB2YWx1ZXMgbGllIGJldHdlZW4gKDAuNSwwLjkpCgoqIGxhbWJkYVtkZWZhdWx0PTBdCiAgICArIEl0IGNvbnRyb2xzIEwyIHJlZ3VsYXJpemF0aW9uIChlcXVpdmFsZW50IHRvIFJpZGdlIHJlZ3Jlc3Npb24pIG9uIHdlaWdodHMuIEl0IGlzIHVzZWQgdG8gYXZvaWQgb3ZlcmZpdHRpbmcuCgoqIGFscGhhW2RlZmF1bHQ9MV0KICAgICsgSXQgY29udHJvbHMgTDEgcmVndWxhcml6YXRpb24gKGVxdWl2YWxlbnQgdG8gTGFzc28gcmVncmVzc2lvbikgb24gd2VpZ2h0cy4gICAgICArIEluIGFkZGl0aW9uIHRvIHNocmlua2FnZSwgZW5hYmxpbmcgYWxwaGEgYWxzbyByZXN1bHRzIGluIGZlYXR1cmUgc2VsZWN0aW9uLiBIZW5jZSwgaXQncyBtb3JlIHVzZWZ1bCBvbiBoaWdoIGRpbWVuc2lvbmFsIGRhdGEgc2V0cy4KCioqUGFyYW1ldGVycyBmb3IgTGluZWFyIEJvb3N0ZXIqKgoKVXNpbmcgbGluZWFyIGJvb3N0ZXIgaGFzIHJlbGF0aXZlbHkgbGVzc2VyIHBhcmFtZXRlcnMgdG8gdHVuZSwgaGVuY2UgaXQgY29tcHV0ZXMgbXVjaCBmYXN0ZXIgdGhhbiBnYnRyZWUgYm9vc3Rlci4KCiogbnJvdW5kc1tkZWZhdWx0PTEwMF0KICAgICsgSXQgY29udHJvbHMgdGhlIG1heGltdW0gbnVtYmVyIG9mIGl0ZXJhdGlvbnMgKHN0ZXBzKSByZXF1aXJlZCBmb3IgZ3JhZGllbnQgZGVzY2VudCB0byBjb252ZXJnZS4KICAgICsgU2hvdWxkIGJlIHR1bmVkIHVzaW5nIENWCgoqIGxhbWJkYVtkZWZhdWx0PTBdCiAgICArIEl0IGVuYWJsZXMgUmlkZ2UgUmVncmVzc2lvbi4gU2FtZSBhcyBhYm92ZQphbHBoYVtkZWZhdWx0PTFdCiAgICArIEl0IGVuYWJsZXMgTGFzc28gUmVncmVzc2lvbi4gU2FtZSBhcyBhYm92ZQoKKiozLiBMZWFybmluZyBUYXNrIFBhcmFtZXRlcnMqKgoKVGhlc2UgcGFyYW1ldGVycyBzcGVjaWZ5IG1ldGhvZHMgZm9yIHRoZSBsb3NzIGZ1bmN0aW9uIGFuZCBtb2RlbCBldmFsdWF0aW9uLiBJbiBhZGRpdGlvbiB0byB0aGUgcGFyYW1ldGVycyBsaXN0ZWQgYmVsb3csIHlvdSBhcmUgZnJlZSB0byB1c2UgYSBjdXN0b21pemVkIG9iamVjdGl2ZSAvIGV2YWx1YXRpb24gZnVuY3Rpb24uCgoqIE9iamVjdGl2ZVtkZWZhdWx0PXJlZzpsaW5lYXJdCiAgICArIHJlZzpsaW5lYXIgLSBmb3IgbGluZWFyIHJlZ3Jlc3Npb24KICAgICsgYmluYXJ5OmxvZ2lzdGljIC0gbG9naXN0aWMgcmVncmVzc2lvbiBmb3IgYmluYXJ5IGNsYXNzaWZpY2F0aW9uLiBJdCByZXR1cm5zIGNsYXNzIHByb2JhYmlsaXRpZXMKICAgICsgbXVsdGk6c29mdG1heCAtIG11bHRpY2xhc3NpZmljYXRpb24gdXNpbmcgc29mdG1heCBvYmplY3RpdmUuIEl0IHJldHVybnMgcHJlZGljdGVkIGNsYXNzIGxhYmVscy4gSXQgcmVxdWlyZXMgc2V0dGluZyBudW1fY2xhc3MgcGFyYW1ldGVyIGRlbm90aW5nIG51bWJlciBvZiB1bmlxdWUgcHJlZGljdGlvbiBjbGFzc2VzLgogICAgKyBtdWx0aTpzb2Z0cHJvYiAtIG11bHRpY2xhc3NpZmljYXRpb24gdXNpbmcgc29mdG1heCBvYmplY3RpdmUuIEl0IHJldHVybnMgcHJlZGljdGVkIGNsYXNzIHByb2JhYmlsaXRpZXMuCgoqIGV2YWxfbWV0cmljIFtubyBkZWZhdWx0LCBkZXBlbmRzIG9uIG9iamVjdGl2ZSBzZWxlY3RlZF0KICAgICsgVGhlc2UgbWV0cmljcyBhcmUgdXNlZCB0byBldmFsdWF0ZSBhIG1vZGVsJ3MgYWNjdXJhY3kgb24gdmFsaWRhdGlvbiBkYXRhLiBGb3IgcmVncmVzc2lvbiwgZGVmYXVsdCBtZXRyaWMgaXMgUk1TRS4gRm9yIGNsYXNzaWZpY2F0aW9uLCBkZWZhdWx0IG1ldHJpYyBpcyBlcnJvci4KICAgICsgQXZhaWxhYmxlIGVycm9yIGZ1bmN0aW9ucyBhcmUgYXMgZm9sbG93czoKICAgICAgICArIG1hZSAtIE1lYW4gQWJzb2x1dGUgRXJyb3IgKHVzZWQgaW4gcmVncmVzc2lvbikKICAgICAgICArIExvZ2xvc3MgLSBOZWdhdGl2ZSBsb2dsaWtlbGlob29kICh1c2VkIGluIGNsYXNzaWZpY2F0aW9uKQogICAgICAgICsgQVVDIC0gQXJlYSB1bmRlciBjdXJ2ZSAodXNlZCBpbiBjbGFzc2lmaWNhdGlvbikKICAgICAgICArIFJNU0UgLSBSb290IG1lYW4gc3F1YXJlIGVycm9yICh1c2VkIGluIHJlZ3Jlc3Npb24pCiAgICAgICAgKyBlcnJvciAtIEJpbmFyeSBjbGFzc2lmaWNhdGlvbiBlcnJvciByYXRlIFsjd3JvbmcgY2FzZXMvI2FsbCBjYXNlc10KICAgICAgICArIG1sb2dsb3NzIC0gbXVsdGljbGFzcyBsb2dsb3NzICh1c2VkIGluIGNsYXNzaWZpY2F0aW9uKQoKIyBQcmFjdGljYWwgLSBUdW5pbmcgWEdCb29zdCBpbiBSCgpJbiB0aGlzIHByYWN0aWNhbCBzZWN0aW9uLCB3ZSdsbCBsZWFybiB0byB0dW5lIHhnYm9vc3QgaW4gdHdvIHdheXM6IHVzaW5nIHRoZSB4Z2Jvb3N0IHBhY2thZ2UgYW5kIE1MUiBwYWNrYWdlLgoKSSdsbCB1c2UgdGhlIFthZHVsdCBkYXRhIHNldF0oaHR0cHM6Ly9hcmNoaXZlLmljcy51Y2kuZWR1L21sL21hY2hpbmUtbGVhcm5pbmctZGF0YWJhc2VzL2FkdWx0LykgLCB0aGlzIGRhdGEgc2V0IHBvc2VzIGEgY2xhc3NpZmljYXRpb24gcHJvYmxlbSB3aGVyZSBvdXIgam9iIGlzIHRvIHByZWRpY3QgaWYgdGhlIGdpdmVuIHVzZXIgd2lsbCBoYXZlIGEgc2FsYXJ5IDw9NTBLIG9yID41MEsuCgpJJ2xsIGZvbGxvdyB0aGUgbW9zdCBjb21tb24gYnV0IGVmZmVjdGl2ZSBzdGVwcyBpbiBwYXJhbWV0ZXIgdHVuaW5nOgoKKyBGaXJzdCwgeW91IGJ1aWxkIHRoZSB4Z2Jvb3N0IG1vZGVsIHVzaW5nIGRlZmF1bHQgcGFyYW1ldGVycy4gWW91IG1pZ2h0IGJlIHN1cnByaXNlZCB0byBzZWUgdGhhdCBkZWZhdWx0IHBhcmFtZXRlcnMgc29tZXRpbWVzIGdpdmUgaW1wcmVzc2l2ZSBhY2N1cmFjeS4KKyBJZiB5b3UgZ2V0IGEgZGVwcmVzc2luZyBtb2RlbCBhY2N1cmFjeSwgZG8gdGhpczogZml4IGV0YSA9IDAuMSwgbGVhdmUgdGhlIHJlc3Qgb2YgdGhlIHBhcmFtZXRlcnMgYXQgZGVmYXVsdCB2YWx1ZSwgdXNpbmcgeGdiLmN2IGZ1bmN0aW9uIGdldCBiZXN0IG5fcm91bmRzLiBOb3csIGJ1aWxkIGEgbW9kZWwgd2l0aCB0aGVzZSBwYXJhbWV0ZXJzIGFuZCBjaGVjayB0aGUgYWNjdXJhY3kuCisgT3RoZXJ3aXNlLCB5b3UgY2FuIHBlcmZvcm0gYSBncmlkIHNlYXJjaCBvbiByZXN0IG9mIHRoZSBwYXJhbWV0ZXJzIChtYXhfZGVwdGgsIGdhbW1hLCBzdWJzYW1wbGUsIGNvbHNhbXBsZV9ieXRyZWUgZXRjKSBieSBmaXhpbmcgZXRhIGFuZCBucm91bmRzLiBOb3RlOiBJZiB1c2luZyBnYnRyZWUsIGRvbid0IGludHJvZHVjZSBnYW1tYSB1bnRpbCB5b3Ugc2VlIGEgc2lnbmlmaWNhbnQgZGlmZmVyZW5jZSBpbiB5b3VyIHRyYWluIGFuZCB0ZXN0IGVycm9yLgorIFVzaW5nIHRoZSBiZXN0IHBhcmFtZXRlcnMgZnJvbSBncmlkIHNlYXJjaCwgdHVuZSB0aGUgcmVndWxhcml6YXRpb24gcGFyYW1ldGVycyhhbHBoYSxsYW1iZGEpIGlmIHJlcXVpcmVkLgorIEF0IGxhc3QsIGluY3JlYXNlL2RlY3JlYXNlIGV0YSBhbmQgZm9sbG93IHRoZSBwcm9jZWR1cmUuIEJ1dCByZW1lbWJlciwgZXhjZXNzaXZlbHkgbG93ZXIgZXRhIHZhbHVlcyB3b3VsZCBhbGxvdyB0aGUgbW9kZWwgdG8gbGVhcm4gZGVlcCBpbnRlcmFjdGlvbnMgaW4gdGhlIGRhdGEgYW5kIGluIHRoaXMgcHJvY2VzcywgaXQgbWlnaHQgY2FwdHVyZSBub2lzZS4gU28gYmUgY2FyZWZ1bCEKCmBgYHtyfQojbG9hZCBsaWJyYXJpZXMKbGlicmFyeShkYXRhLnRhYmxlKQpsaWJyYXJ5KG1scikKCiNzZXQgdmFyaWFibGUgbmFtZXMKc2V0Y29sIDwtIGMoImFnZSIsCiAgICAgICAgICAgICJ3b3JrY2xhc3MiLAogICAgICAgICAgICAiZm5sd2d0IiwKICAgICAgICAgICAgImVkdWNhdGlvbiIsCiAgICAgICAgICAgICJlZHVjYXRpb24tbnVtIiwKICAgICAgICAgICAgIm1hcml0YWwtc3RhdHVzIiwKICAgICAgICAgICAgIm9jY3VwYXRpb24iLAogICAgICAgICAgICAicmVsYXRpb25zaGlwIiwKICAgICAgICAgICAgInJhY2UiLAogICAgICAgICAgICAic2V4IiwKICAgICAgICAgICAgImNhcGl0YWwtZ2FpbiIsCiAgICAgICAgICAgICJjYXBpdGFsLWxvc3MiLAogICAgICAgICAgICAiaG91cnMtcGVyLXdlZWsiLAogICAgICAgICAgICAibmF0aXZlLWNvdW50cnkiLAogICAgICAgICAgICAidGFyZ2V0IikKCiNsb2FkIGRhdGEKdHJhaW4gPC0gcmVhZC50YWJsZSgieGdib29zdF9hZHVsdGRhdGEuZGF0YSIsaGVhZGVyID0gRixzZXAgPSAiLCIsY29sLm5hbWVzID0gc2V0Y29sLG5hLnN0cmluZ3MgPSBjKCIgPyIpLHN0cmluZ3NBc0ZhY3RvcnMgPSBGKQp0ZXN0IDwtIHJlYWQudGFibGUoInhnYm9vc3RfYWR1bHR0ZXN0LnRlc3QiLGhlYWRlciA9IEYsc2VwID0gIiwiLGNvbC5uYW1lcyA9IHNldGNvbCxza2lwID0gMSwgbmEuc3RyaW5ncyA9IGMoIiA/Iiksc3RyaW5nc0FzRmFjdG9ycyA9IEYpCgojY29udmVydCBkYXRhIGZyYW1lIHRvIGRhdGEgdGFibGUKc2V0RFQodHJhaW4pCnNldERUKHRlc3QpCgojY2hlY2sgbWlzc2luZyB2YWx1ZXMKdGFibGUoaXMubmEodHJhaW4pKQpzYXBwbHkodHJhaW4sIGZ1bmN0aW9uKHgpIHN1bShpcy5uYSh4KSkvbGVuZ3RoKHgpKSoxMDAKdGFibGUoaXMubmEodGVzdCkpCnNhcHBseSh0ZXN0LCBmdW5jdGlvbih4KSBzdW0oaXMubmEoeCkpL2xlbmd0aCh4KSkqMTAwCgojcXVpY2sgZGF0YSBjbGVhbmluZwojcmVtb3ZlIGV4dHJhIGNoYXJhY3RlciBmcm9tIHRhcmdldCB2YXJpYWJsZQpsaWJyYXJ5KHN0cmluZ3IpCnRlc3RbLHRhcmdldCA6PSBzdWJzdHIodGFyZ2V0LHN0YXJ0ID0gMSxzdG9wID0gbmNoYXIodGFyZ2V0KS0xKV0KCiNyZW1vdmUgbGVhZGluZyB3aGl0ZXNwYWNlcwpjaGFyX2NvbCA8LSBjb2xuYW1lcyh0cmFpbilbc2FwcGx5KHRlc3QsaXMuY2hhcmFjdGVyKV0KZm9yKGkgaW4gY2hhcl9jb2wpCiAgICAgIHNldCh0cmFpbixqPWksdmFsdWUgPSBzdHJfdHJpbSh0cmFpbltbaV1dLHNpZGUgPSAibGVmdCIpKQpmb3IoaSBpbiBjaGFyX2NvbCkKICAgICAgc2V0KHRlc3Qsaj1pLHZhbHVlID0gc3RyX3RyaW0odGVzdFtbaV1dLHNpZGUgPSAibGVmdCIpKQoKI3NldCBhbGwgbWlzc2luZyB2YWx1ZSBhcyAiTWlzc2luZyIKdHJhaW5baXMubmEodHJhaW4pXSA8LSAiTWlzc2luZyIKdGVzdFtpcy5uYSh0ZXN0KV0gPC0gIk1pc3NpbmciCmBgYAoKVG8gdXNlIHhnYm9vc3QgcGFja2FnZSwga2VlcCB0aGVzZSB0aGluZ3MgaW4gbWluZDoKKyBDb252ZXJ0IHRoZSBjYXRlZ29yaWNhbCB2YXJpYWJsZXMgaW50byBudW1lcmljIHVzaW5nIG9uZSBob3QgZW5jb2RpbmcKKyBGb3IgY2xhc3NpZmljYXRpb24sIGlmIHRoZSBkZXBlbmRlbnQgdmFyaWFibGUgYmVsb25ncyB0byBjbGFzcyBmYWN0b3IsIGNvbnZlcnQgaXQgdG8gbnVtZXJpYwoKUidzIGJhc2UgZnVuY3Rpb24gbW9kZWwubWF0cml4IGlzIHF1aWNrIGVub3VnaCB0byBpbXBsZW1lbnQgb25lIGhvdCBlbmNvZGluZy4gSW4gdGhlIGNvZGUgYmVsb3csIH4uKzAgbGVhZHMgdG8gZW5jb2Rpbmcgb2YgYWxsIGNhdGVnb3JpY2FsIHZhcmlhYmxlcyB3aXRob3V0IHByb2R1Y2luZyBhbiBpbnRlcmNlcHQuIEFsdGVybmF0aXZlbHksIHlvdSBjYW4gdXNlIHRoZSBkdW1taWVzIHBhY2thZ2UgdG8gYWNjb21wbGlzaCB0aGUgc2FtZSB0YXNrLiBTaW5jZSB4Z2Jvb3N0IHBhY2thZ2UgYWNjZXB0cyB0YXJnZXQgdmFyaWFibGUgc2VwYXJhdGVseSwgd2UnbGwgZG8gdGhlIGVuY29kaW5nIGtlZXBpbmcgdGhpcyBpbiBtaW5kOgpgYGB7cn0KI3VzaW5nIG9uZSBob3QgZW5jb2RpbmcKbGFiZWxzIDwtIHRyYWluJHRhcmdldAp0c19sYWJlbCA8LSB0ZXN0JHRhcmdldApuZXdfdHIgPC0gbW9kZWwubWF0cml4KH4uKzAsZGF0YSA9IHRyYWluWywtYygidGFyZ2V0Iiksd2l0aD1GXSkKbmV3X3RzIDwtIG1vZGVsLm1hdHJpeCh+LiswLGRhdGEgPSB0ZXN0WywtYygidGFyZ2V0Iiksd2l0aD1GXSkKCiNjb252ZXJ0IGZhY3RvciB0byBudW1lcmljCmxhYmVscyA8LSBhcy5udW1lcmljKGFzLmZhY3RvcihsYWJlbHMpKS0xCnRzX2xhYmVsIDwtIGFzLm51bWVyaWMoYXMuZmFjdG9yKHRzX2xhYmVsKSktMQpgYGAKRm9yIHhnYm9vc3QsIHdlJ2xsIHVzZSB4Z2IuRE1hdHJpeCB0byBjb252ZXJ0IGRhdGEgdGFibGUgaW50byBhIG1hdHJpeCAobW9zdCByZWNvbW1lbmRlZCk6CgpgYGB7cn0KI3ByZXBhcmluZyBtYXRyaXgKZHRyYWluIDwtIHhnYi5ETWF0cml4KGRhdGEgPSBuZXdfdHIsbGFiZWwgPSBsYWJlbHMpCmR0ZXN0IDwtIHhnYi5ETWF0cml4KGRhdGEgPSBuZXdfdHMsbGFiZWw9dHNfbGFiZWwpCgojZGVmYXVsdCBwYXJhbWV0ZXJzCnBhcmFtcyA8LSBsaXN0KAogICAgICAgIGJvb3N0ZXIgPSAiZ2J0cmVlIiwKICAgICAgICBvYmplY3RpdmUgPSAiYmluYXJ5OmxvZ2lzdGljIiwKICAgICAgICBldGE9MC4zLAogICAgICAgIGdhbW1hPTAsCiAgICAgICAgbWF4X2RlcHRoPTYsCiAgICAgICAgbWluX2NoaWxkX3dlaWdodD0xLAogICAgICAgIHN1YnNhbXBsZT0xLAogICAgICAgIGNvbHNhbXBsZV9ieXRyZWU9MQopCgp4Z2JjdiA8LSB4Z2IuY3YocGFyYW1zID0gcGFyYW1zCiAgICAgICAgICAgICAgICAsZGF0YSA9IGR0cmFpbgogICAgICAgICAgICAgICAgLG5yb3VuZHMgPSAxMDAKICAgICAgICAgICAgICAgICxuZm9sZCA9IDUKICAgICAgICAgICAgICAgICxzaG93c2QgPSBUCiAgICAgICAgICAgICAgICAsc3RyYXRpZmllZCA9IFQKICAgICAgICAgICAgICAgICxwcmludC5ldmVyeS5uID0gMTAKICAgICAgICAgICAgICAgICxlYXJseS5zdG9wLnJvdW5kID0gMjAKICAgICAgICAgICAgICAgICxtYXhpbWl6ZSA9IEYKKQojI2Jlc3QgaXRlcmF0aW9uID0gNzkKCm1pbih4Z2JjdiR0ZXN0LmVycm9yLm1lYW4pCiMwLjEyNjMKCiNmaXJzdCBkZWZhdWx0IC0gbW9kZWwgdHJhaW5pbmcKeGdiMSA8LSB4Z2IudHJhaW4oCiAgICAgICAgICAgcGFyYW1zID0gcGFyYW1zCiAgICAgICAgICAsZGF0YSA9IGR0cmFpbgogICAgICAgICAgLG5yb3VuZHMgPSA3OQogICAgICAgICAgLHdhdGNobGlzdCA9IGxpc3QodmFsPWR0ZXN0LHRyYWluPWR0cmFpbikKICAgICAgICAgICxwcmludC5ldmVyeS5uID0gMTAKICAgICAgICAgICxlYXJseS5zdG9wLnJvdW5kID0gMTAKICAgICAgICAgICxtYXhpbWl6ZSA9IEYKICAgICAgICAgICxldmFsX21ldHJpYyA9ICJlcnJvciIKKQoKI21vZGVsIHByZWRpY3Rpb24KeGdicHJlZCA8LSBwcmVkaWN0KHhnYjEsZHRlc3QpCnhnYnByZWQgPC0gaWZlbHNlKHhnYnByZWQgPiAwLjUsMSwwKQoKI2NvbmZ1c2lvbiBtYXRyaXgKbGlicmFyeShjYXJldCkKY29uZnVzaW9uTWF0cml4KHhnYnByZWQsIHRzX2xhYmVsKQojQWNjdXJhY3kgLSA4Ni41NCUKCiN2aWV3IHZhcmlhYmxlIGltcG9ydGFuY2UgcGxvdAptYXQgPC0geGdiLmltcG9ydGFuY2UoZmVhdHVyZV9uYW1lcyA9IGNvbG5hbWVzKG5ld190ciksbW9kZWwgPSB4Z2IxKQp4Z2IucGxvdC5pbXBvcnRhbmNlKGltcG9ydGFuY2VfbWF0cml4ID0gbWF0WzE6MjBdKSAjZmlyc3QgMjAgdmFyaWFibGVzCmBgYAoKTGV0J3MgcHJvY2VlZCB0byB0aGUgcmFuZG9tIC8gZ3JpZCBzZWFyY2ggcHJvY2VkdXJlIGFuZCBhdHRlbXB0IHRvIGZpbmQgYmV0dGVyIGFjY3VyYWN5LiBGcm9tIGhlcmUgb24sIHdlJ2xsIGJlIHVzaW5nIHRoZSBNTFIgcGFja2FnZSBmb3IgbW9kZWwgYnVpbGRpbmcuIEEgcXVpY2sgcmVtaW5kZXIsIHRoZSBNTFIgcGFja2FnZSBjcmVhdGVzIGl0cyBvd24gZnJhbWUgb2YgZGF0YSwgbGVhcm5lciBhcyBzaG93biBiZWxvdy4gQWxzbywga2VlcCBpbiBtaW5kIHRoYXQgdGFzayBmdW5jdGlvbnMgaW4gbWxyIGRvZXNuJ3QgYWNjZXB0IGNoYXJhY3RlciB2YXJpYWJsZXMuIEhlbmNlLCB3ZSBuZWVkIHRvIGNvbnZlcnQgdGhlbSB0byBmYWN0b3JzIGJlZm9yZSBjcmVhdGluZyB0YXNrOgpgYGB7cn0KI2NvbnZlcnQgY2hhcmFjdGVycyB0byBmYWN0b3JzCmZhY3RfY29sIDwtIGNvbG5hbWVzKHRyYWluKVtzYXBwbHkodHJhaW4saXMuY2hhcmFjdGVyKV0KZm9yKGkgaW4gZmFjdF9jb2wpCiAgICAgICAgc2V0KHRyYWluLGo9aSx2YWx1ZSA9IGZhY3Rvcih0cmFpbltbaV1dKSkKZm9yKGkgaW4gZmFjdF9jb2wpCiAgICAgICAgc2V0KHRlc3Qsaj1pLHZhbHVlID0gZmFjdG9yKHRlc3RbW2ldXSkpCgojY3JlYXRlIHRhc2tzCnRyYWludGFzayA8LSBtYWtlQ2xhc3NpZlRhc2soZGF0YSA9IHRyYWluLHRhcmdldCA9ICJ0YXJnZXQiKQp0ZXN0dGFzayA8LSBtYWtlQ2xhc3NpZlRhc2soZGF0YSA9IHRlc3QsdGFyZ2V0ID0gInRhcmdldCIpCgojZG8gb25lIGhvdCBlbmNvZGluZwp0cmFpbnRhc2sgPC0gY3JlYXRlRHVtbXlGZWF0dXJlcyhvYmogPSB0cmFpbnRhc2spCnRlc3R0YXNrIDwtIGNyZWF0ZUR1bW15RmVhdHVyZXMob2JqID0gdGVzdHRhc2spCmBgYAoKYGBge3J9CiNjcmVhdGUgbGVhcm5lcgpscm4gPC0gbWFrZUxlYXJuZXIoImNsYXNzaWYueGdib29zdCIscHJlZGljdC50eXBlID0gInJlc3BvbnNlIikKbHJuJHBhci52YWxzIDwtIGxpc3QoCiAgICAgICAgICAgICBvYmplY3RpdmU9ImJpbmFyeTpsb2dpc3RpYyIsCiAgICAgICAgICAgICBldmFsX21ldHJpYz0iZXJyb3IiLAogICAgICAgICAgICAgbnJvdW5kcz0xTCwKICAgICAgICAgICAgIGV0YT0wLjEKKQoKI3NldCBwYXJhbWV0ZXIgc3BhY2UKcGFyYW1zIDwtIG1ha2VQYXJhbVNldCgKICAgICAgICAgbWFrZURpc2NyZXRlUGFyYW0oImJvb3N0ZXIiLHZhbHVlcyA9IGMoImdidHJlZSIsImdibGluZWFyIikpLAogICAgICAgICBtYWtlSW50ZWdlclBhcmFtKCJtYXhfZGVwdGgiLGxvd2VyID0gM0wsdXBwZXIgPSAxMEwpLAogICAgICAgICBtYWtlTnVtZXJpY1BhcmFtKCJtaW5fY2hpbGRfd2VpZ2h0Iixsb3dlciA9IDFMLHVwcGVyID0gMTBMKSwKICAgICAgICAgbWFrZU51bWVyaWNQYXJhbSgic3Vic2FtcGxlIixsb3dlciA9IDAuNSx1cHBlciA9IDEpLAogICAgICAgICBtYWtlTnVtZXJpY1BhcmFtKCJjb2xzYW1wbGVfYnl0cmVlIixsb3dlciA9IDAuNSx1cHBlciA9IDEpCikKCiNzZXQgcmVzYW1wbGluZyBzdHJhdGVneQpyZGVzYyA8LSBtYWtlUmVzYW1wbGVEZXNjKCJDViIsc3RyYXRpZnkgPSBULGl0ZXJzPTVMKQoKI3NlYXJjaCBzdHJhdGVneQpjdHJsIDwtIG1ha2VUdW5lQ29udHJvbFJhbmRvbShtYXhpdCA9IDVMKQoKI3NldCBwYXJhbGxlbCBiYWNrZW5kCiNsaWJyYXJ5KHBhcmFsbGVsKQojbGlicmFyeShwYXJhbGxlbE1hcCkKI3BhcmFsbGVsU3RhcnRTb2NrZXQoY3B1cyA9IDIpCgojcGFyYW1ldGVyIHR1bmluZwpteXR1bmUgPC0gdHVuZVBhcmFtcyhsZWFybmVyID0gbHJuCiAgICAgICAgICAgICAgICx0YXNrID0gdHJhaW50YXNrCiAgICAgICAgICAgICAgICxyZXNhbXBsaW5nID0gcmRlc2MKICAgICAgICAgICAgICAgLG1lYXN1cmVzID0gYWNjCiAgICAgICAgICAgICAgICxwYXIuc2V0ID0gcGFyYW1zCiAgICAgICAgICAgICAgICxjb250cm9sID0gY3RybAogICAgICAgICAgICAgICAsc2hvdy5pbmZvID0gVCkKCm15dHVuZSR5ICMwLjg3MzA2OQoKI3NldCBoeXBlcnBhcmFtZXRlcnMKbHJuX3R1bmUgPC0gc2V0SHlwZXJQYXJzKGxybixwYXIudmFscyA9IG15dHVuZSR4KQoKI3RyYWluIG1vZGVsCnhnbW9kZWwgPC0gbWxyOjp0cmFpbihsZWFybmVyID0gbHJuX3R1bmUsdGFzayA9IHRyYWludGFzaykKCiNwcmVkaWN0IG1vZGVsCnhncHJlZCA8LSBwcmVkaWN0KHhnbW9kZWwsdGVzdHRhc2spCgpjb25mdXNpb25NYXRyaXgoeGdwcmVkJGRhdGEkcmVzcG9uc2UseGdwcmVkJGRhdGEkdHJ1dGgpCiNBY2N1cmFjeSA6IDAuODc0NwoKI3N0b3AgcGFyYWxsZWxpemF0aW9uCiNwYXJhbGxlbFN0b3AoKQpgYGAKCg==