Instructions and Overview

Welcome to the Data Ethnographies Lab Book! Together, the nine notebooks in this Lab Book will walk you through a research project contextualizing, exploring, and visualizing a publicly-accessible dataset. Each notebook will demonstrate how to explore a dataset in R, along with modes of critical reflection that can help you evaluate the collective values and commitments that shape data and the stories it conveys. Labs 2-3 will involve research planning, data discovery, and data background research. Labs 4-7 will involve data exploration, analysis, and critique. Finally, labs 8 and 9 will involve summarizing findings, documenting knowledge gaps, and presenting uncertainty.

As we move through this first notebook, we will begin to get acquainted with R Markdown - the format in which these notebooks are written -, the themes of the notebooks, and the statistical programming language R. If you are here because you are looking to become a whiz at statistical analysis or data science, you should know that this is not the primary goal of these notebooks. Instead, the notebooks are designed to encourage you to think critically about a data practice - recognizing the human forces that are always involved in shaping data, responsibly documenting uncertainties in data, and communicating ways that data can both produce and delimit insight. While analyzing data in appropriate ways are important parts of each notebook, the reflections that you will write about the analyses you produce are perhaps even more important.

Introduction to RStudio

As we work through these notebooks, we will be learning how to code in R inside the RStudio interface. You may be wondering the difference between the two.

R is a statistical computing language that allows you to: * Store data in a variety of formats * Perform calculations on data and variables, * Build functions and applications, and * Transform and graphically represent data

RStudio is an Integrated Development Environment (IDE) for statistical computing. It is a platform for using and coding in R.

Before we continue, please watch this 8-minute video introducing you to the RStudio Environment.

Installing Packages

The R community has developed a series of packages or collections of functions that we can use when coding in R. We will be leveraging a series of packages known as the Tidyverse - designed to help users clean, transform, analyze, and visualize data. You will need to install the following packages in your R environment. To do so, you should copy and paste the following line into your Console. If you don’t know where you console is, be sure to rewatch the RStudio YouTube video above.

install.packages(c(“tidyverse”, “lubridate”, “rmarkdown”, “leaflet”))

Once packages are installed, to load the package, we call the function library(), which let’s R know that we will be referencing the functions encoded for this package in our code. You can think of an R package like a book, stored in a computer library. When you call, library(), it is as if we are checking that book out of the library so that we may reference its functions in our code. Run the code below after installing the packages above to ensure that everything installed properly. Refer to the video above if you do not know how to run the code.

library(tidyverse)
Registered S3 methods overwritten by 'dbplyr':
  method         from
  print.tbl_lazy     
  print.tbl_sql      
── Attaching packages ──────────────────────────────────────────────────────────────────────── tidyverse 1.3.0 ──
✓ ggplot2 3.3.2     ✓ purrr   0.3.4
✓ tibble  3.0.4     ✓ dplyr   1.0.2
✓ tidyr   1.1.2     ✓ stringr 1.4.0
✓ readr   1.4.0     ✓ forcats 0.5.0
── Conflicts ─────────────────────────────────────────────────────────────────────────── tidyverse_conflicts() ──
x dplyr::filter() masks stats::filter()
x dplyr::lag()    masks stats::lag()
library(lubridate)

Attaching package: ‘lubridate’

The following objects are masked from ‘package:base’:

    date, intersect, setdiff, union
library(rmarkdown)
library(leaflet)
Registered S3 method overwritten by 'htmlwidgets':
  method           from         
  print.htmlwidget tools:rstudio

Introduction to R Markdown

If you are viewing this document in RStudio, you’ll notice a series of characters (like hashtags and asterisks) being used to demarcate headers, code chunks, italicized and emphasized words, bullets, numbering, figures, and tables. These characters are encoding how the document should be presented when we publish it. These symbols are part of R Markdown - an authoring framework for R that enables us to style documents and embed code. When we publish this document, you see the text following or in between these symbols formatted in a standardized way. If you would like to see how this document will appear once it’s published, click the ‘Preview’ button in the navigation bar above. This will preview the published document in the Viewer to the right.

Here are some components of R Markdown that you may see throughout the notebooks.

Code Chunks

This grey box between ```{r} and ``` is a code chunk. 

Typically, when we put code in this chunk and then publish our R Markdown document, 
the code written here will be run and output on the screen. 

However, by placing eval=FALSE in the brackets, we tell R not to evaluate the code. 

This is useful when we are just filling text into the code chunk.

Headings

Use ‘#’ to create headings:

Heading 1

Heading 2

Heading 3

Tables

Tables can be formated like this:

Header 1 Header 1
Cell 1 Cell 2
Cell 3 Cell 4

Bullets and Numbering

You can bullet content using the ’*’:

  • Point 1
  • Point 2

You can number content like this:

  1. Point 1
  2. Point 2

For more information about formatting documents in R Markdown see this cheatsheet. Note how I created a hyperlink here!

Lab Book Themes

On March 30, 2020, Nate Silver - who had been vociferously vocal in sharing his insights into data regarding the Covid-19 pandemic - tweeted out to his networks:

The tweet really nicely sums up an overriding theme of these Lab Books. We can learn all sorts of techniques to produce beautiful charts, tables, and visualizations with data. But when we are dealing with messy, complex, and dynamic phenomena, such techniques can hide just how much uncertainty there is in data and just how much situated human perspective is interwoven through numeric calculations. This Lab Book is designed to encourage you to always keep these issues in mind as you engage in data analysis.

Do we all know who Nate Silver is? Nate Silver gained notoriety following the 2008 US presidential election, when he first accurately predicted the results of 49 of the 50 states. By the 2012 election, his data had accurately predicted the results of all 50 states. His website FiveThirtyEight.com was quickly acquired by the New York Times and later by ESPN and ushered in a new wave of work at the intersection of data science and election forecasting. However, Nate Silver is well-acquainted with messy and uncertain data. While none of the major polling sites were able to accurately predict the results of the 2016 US presidential election, FiveThirtyEight’s predictions (while placing the chances of a Trump victory higher than other news sources) were perhaps most surprising following his success in previous elections. By election day, FiveThirtyEight had placed the likelihood of a Clinton victory at 70%. I remember watching the news on election night and, as an anthropologist of data, almost falling out of my chair when I heard political correspondent Mike Murphy claim that “Today, data kind of died.” Watch the clip below:

An important lesson that emerged from this incredible data flop is just how important it is to be be able to critique our data landscape - to question what data is available and what data is not available, to consider how representative data may be of complex issues, and to acknowledge and communicate data uncertainties. The 2016 polls failed to consider a number of things. While widespread polling had been taking the pulse of the country in the months leading up to the election, pollsters underestimated the impact that voters undecided at the time polls were taken could have on the overall results. They failed to account for data uncertainty. Further, not every person in the country is polled leading up to the election. When determining who to poll, pollsters devise “representative samples” of the population - reaching out to likely voters in diverse age brackets, with diverse income levels, and with diverse educational backgrounds. They have to make a lot of assumptions about the composition of the country when coming up with these sample - often relying on how elections played out in the past, along with what has culturally changed since past elections, to predict how they will play out in the future. In 2016, many of their assumptions about the country’s composition were wrong.

As statisticians turn their attention to the current public health crisis around Covid-19, such considerations should be at the forefront of our minds. As we will see throughout these notebooks, the data that we have about Covid-19 is incredibly messy and riddled with inconsistencies. Data scientists and international organizations have had to very quickly aggregate data from all corners of the world - collecting case counts from countries with different medical systems, different standards for medical data reporting, and different politics. These countries themselves are trying to figure out how to gather this data from states and provinces, and states and provinces themselves are trying to figure out how to gather this data from hospitals. The coordinational capacity needed to produce the numbers that we eventually see is enormous, demanding considerable global information infrastructure.

Further, as we will consider again and again throughout the notebooks, the case count data that we have is only as good as the amount of testing for the virus that is taking place, and in many countries, including the US, testing has been incredibly slow. This guarantees that case counts will be under-reported. These are the types of issues Nate Silver is referring to when he tells the world to stop trying to produce pretty graphs of the spread.

Ethnography

Every discipline has a set of methods that they leverage to advance research in their fields. Disciplinary research methods refer to the techniques and practices a particular discipline engages in order to gather data, analyze evidence, and deepen knowledge on a particular topic. For chemists, such methods might include experimentation and observation. For psychologists, such methods might include case studies and neuro-imaging. I’m an anthropologist, and in anthropology, one of our key methods is known as ethnography.

Ethnography is the practice of studying people and cultures. To do so, ethnographers may observe people as they interact in, move through, or make decisions within a particular space. Alternatively, they may interview people, eliciting narratives about what they find important, how they think about the world, and how their personal backgrounds have motivated their current commitments. Importantly, ethnography is often immersive; ethnographers deeply engage in a particular space, gathering as much detail as they can (and often more detail than they know what to do with) in order to later analyze and relay how cultural forces are operating within it.

In this Lab Book, we are going to conduct an ethnography of a dataset. You may be asking - if ethnography is about studying people, why are we using it to study a dataset? The reason for this is that, in these notebooks, we are taking as a given that all data has in certain ways been shaped by human assumptions, judgments, and politics. Let me provide an example:

The last time I ran this course, one student spent the quarter studying a dataset documenting the perimeters of each documented wildfire in California since 1900. Each row in the dataset documented a fire name, the date the first alarm was sounded, the date it was contained, and the acreage that it burned. Each fire was also classified with a standardized list of fire “causes.” This list included causes like “Campfire,” “Arson,” and “Lightning.” The student created visualizations of the number of documented fires in California that had been the result of each cause. In doing so, she found something odd - the cause of the fewest fires in California were collectively categorized as “Illegal Alien Campfires.”

fires <- read.csv("https://raw.githubusercontent.com/lindsaypoirier/STS-115/master/datasets/Fires_100.csv", stringsAsFactors = FALSE)
fires %>% 
  ggplot(aes(x = reorder(CAUSE,CAUSE,
                     function(x)-length(x)), fill = CAUSE)) +
  geom_bar() +
  labs(title = "Count of CalFIRE-documented Wildfires since 1878 by Cause", x = "Cause", y = "Count of Wildfires") + 
  theme_minimal() +
  theme(legend.position = "none", 
        plot.title = element_text(size = 12, face = "bold")) +
  coord_flip() 

We immediately flagged this. Why did this classification exist as its own separate category? Why was it not enough to classify these fires as “Campfires” - another cause code in the dataset? This communicated to us that at a particular point in time, a governing body in California deemed it appropriate to count illegal alien campfires fires separately - producing a set a numbers and values that tell a different story than the one that would have been produced had all “campfires” been lumped together. In this case, we needed to look beyond the numbers reported in order to make sense of what we were seeing in her analysis - taking into consideration how certain politics were at work in shaping what we were seeing. This opened up even more questions. What counts as a wildfire anyways? Who gets to decide?

When we ethnographically analyze a dataset - immersing ourselves in it to investigate the cultural forces at play - we can pull such narratives to the fore. Accordingly, in these notebooks, we are not only going to consider what quantitative insights we can extrapolate from data. We are also going to analyze the data for what it tells us about culture - how people perceive difference and belonging, how people represent complex ideas numerically, and how they prioritize certain forms of knowledge over others.

A Note on the Word Bias

Some of you may be thinking - if there are human perspectives shaping data, doesn’t that make it biased?

The Oxford English Dictionary defines bias as:

“An inclination, leaning, tendency, bent; a preponderating disposition or propensity; predisposition towards; predilection; prejudice.”

All too often I hear people talk about the significance of “eliminating bias” from data or “avoiding biases” in data analysis. This is firstly impossible. Numbers do not emerge out of nowhere but emerge from human perspectives (with inclinations, leanings, tendencies, and bents) deciding what to count and how to count it. I challenge any one of you to approach me with a number that has not in some way been generated by a human (hint: this is a trick - if you, as a human, come to me with a number, you’ve already failed the challenge.) You can never remove that human element from data; there will always be bias. If you think about it, even the fervent commitment to remove bias from data is a bias!

Secondly, suggesting the possibility that data can be neutral can actually exacerbate certain kinds of social injustices. When we suggest that it is possible for numbers to speak for themselves, we tend to ignore all of the ways that data can be weaponized against groups of people. We are seeing this play out constantly in the news today. So-called “unbiased” algorithms for predicting where crime will happen turn into tools of surveillance for poor and racially diverse communities:

So-called “unbiased” algorithms for screening resumes turn out to favor men over women and transgender individuals:

In this sense, falsely presenting a possibility of eliminating bias gives numbers too much rhetorical power, making it much harder to critique the injustices they propagate.

This is not to say that we shouldn’t critique data representations and combat data practices that propagate inequality or harm certain communities; we absolutely should. However, in a world where this is playing out, I would much prefer to know the politics and perspectives of the individuals collecting data and producing data analyses than to pretend they don’t exist. Then I can decide for myself whether I find their work trustworthy. We need ethical and politically responsible human data stewards - not processes that pretend to be able to strip data of its humanness. I hope you see these notebooks as an opportunity to develop some of these skills. Throughout our work, we will take biased data as a given and figure out how to move from there.

With this in mind, I have a recommendation for how you think about the term ‘bias’ in these notebooks. Any time you feel compelled to use any version of the word ‘bias’, I encourage you to highlight it and then outline three things:

  1. What kind of bias are you referring to?
  2. Who propagates that bias?
  3. What are the consequences of that bias?

You may find that it will take some practice to do this. The word bias has become so ingrained in popular lexicon that we can sometimes forget why we should pay attention to or care about it in the first place. These notebooks are designed to get you to think more critically about when, why, and how biases in data matter and to push beyond seeing them as a problem with data in and of themselves.

Introduction to R

At this point, we will begin to review some basic functionality in R. If you have coded in R before, this will largely be a refresher. If you have never coded in R before, don’t worry. This section is primarily designed to get you acclimated to the language and symbols you will see in future notebooks. Later notebooks will review some of this material as you compose your own code in R. As you read through each section, be sure to run the code chunks to see how the code is operating.

Assigning Variables

Variables are used to store data in R. We use “<-” to assign a variable. The text that comes before “<-” will be our variable name, and the text that comes after “<-” will be the value stored in it.

#Run this code chunk. 

class_name <- "Data Sense and Exploration"
class_dept <- "STS"
class_number <- "115"
class_size <- 33

sts_majors <- 20
stats_majors <- 8
other <- 5

Every object in R has a particular class, which designates the variable’s “type” and how functions can be applied to it. We can check the class of a variable by calling it in “class()”.

class(class_name)
class(class_size)
class(class_number)

Did you notice how class_number above is a character variable? This is because when we created the class_number variable above, we put the number in quotation marks - indicating to R to treat the number as a set of characters rather than a number. Since our class number is a reference to our class, it acts more like a label than a number.

If someone drops a class, we can easily change the value of the class size variable.

#Store the calculation in a variable.
class_size <- class_size - 1

#Print the variable
class_size

Notice how we re-assigned the new subtracted value to class_size above.

We can also perform calculations on variables, such as addition, subtraction, multiplication, and division. Checking whether variables are greater than, less than, or equal to each other will return TRUE or FALSE.

sts_majors + stats_majors

sts_majors > stats_majors

We can also perform operations on strings - concatenating them with the paste function. For instance, we can paste the class_dept string with the class_number string to create a class code. When we do this, we need to tell R what characters should separate the strings. We will review this again later in the quarter.

class_code <- paste(class_dept, class_number, sep=" ")
class_code

Vectors

A vector is a set of values (organized like a list) that are all of the same type. A vector can be of type integer, double, characters, logical, for example. We create a vector by placing a set of values in "c(___)“. Here c stands for”combine" - indicating that we are combining values.

birth_months <- c(4, 7, 12, 3, 1)
first_letter_name <- c("A","B","C","D","E")
time_on_phone <- c(34, 90, 2, 6, NA)

We can measure the length of a vector by calling the function length. This counts how many values are listed in the vector.

length(birth_months)

We can also extract values from specific positions in the vector by referencing the index in brackets. So let’s say I want to extract the third value in the vector.

birth_months[3]

To extract all values except the value in a particular position, we will use the “-” sign before the index in brackets. So let’s say I want to extract all values except the third in the vector.

birth_months[-3]

We can also extract a range of values from specific positions in the vector by referencing that range of indexes in brackets separated by a “:”. So let’s say I want to extract the first through the third value in the vector.

first_letter_name[1:3]

Finally, to extract values from a non-sequential combination of specific positions in the vector, we can reference each of their indexes in brackets in “c()”.

first_letter_name[c(1,3,5)]

We can perform operations on vectors - finding their max, their min, their sum, their average, for example. However, we may get an error if we have any empty values in the dataset. To avoid this, we need to communicate to R to remove NA values.

max(time_on_phone)
min(time_on_phone)
sum(time_on_phone)
mean(time_on_phone)

max(time_on_phone, na.rm=TRUE)
min(time_on_phone, na.rm=TRUE)
sum(time_on_phone, na.rm=TRUE)
mean(time_on_phone, na.rm=TRUE)

Matrices

We won’t be using matrices in these notebooks. However, knowing this data type will help you understand its differences from the data types we will use. Let’s create a second numeric vector.

birth_months2 <- c(11, 12, 3, 4, 4)

By binding this together with birth_months, we create a matrix - or a 2-dimensional collection of elements of all the same type.

birth_months_matrix <- rbind(birth_months, birth_months2)
birth_months_matrix

We can determine the number of rows in the matrix by calling nrow and we can determine the number of columns in the matrix by calling ncol.

nrow(birth_months_matrix)
ncol(birth_months_matrix)

We can also extract values from specific positions in the vector by referencing the row position and the column position of the number in brackets. The format for doing so is [row, column] So let’s say that we want to extract the value in the second row, third column.

birth_months_matrix[2,3]

To extract the entire second row, we would leave the column position blank. This would return a vector of values stored in the second row of the matrix.

birth_months_matrix[2,]

And to extract the entire third column, we would leave the row position blank. This would return a vector of values stored in the third column of the matrix.

birth_months_matrix[,3]

Lists

I will only briefly go over lists because, for the most part, we will not be using them in these notebooks. Lists are collections of objects in R. For instance, you can have a collection of numeric vectors, character vectors, logical vectors, matrices, and other lists. You can assign names to the objects in lists so that you can more easily reference them. For instance, below I assign the name x, y, and z to the three objects respectively. Once a name has been assigned to the object, you can reference it by listing the name of the list followed by the $ followed by the name of the object.

first_list <- list(x = first_letter_name, y = time_on_phone, z = birth_months)

first_list$x[2:3]
first_list$y[c(1,4)]
first_list$z[2]

Data Frames

In these notebooks, we will be working primarily with rectangular datasets in a data type called a data frame. A data frame has a certain number of rows and a certain number of columns. It is a list of vectors of all the same length.

From this point forward, we will refer to each row in a data frame as an observation and each column in a data frame as a variable. This is because rows refer to something that we see in the world, and columns describe that thing we are seeing. Imagine we have a table like this below.

Name Age Birth Month Time on Phone
Sally 23 3 42
Julie 40 2 98
Mark 14 8 120

Each row is an observation - in this case a person - and each column is a variable describing something about a person. Note how each column is also a vector. The Name column is a character vector of names. The Age column is a numeric vector of ages.

Let’s go head and create this vector below:

df <- data.frame(name = c("Sally", "Julie", "Mike"), 
                 age = c(23, 40, 14), 
                 birth_month = c(3, 2, 8),
                 time_on_phone = c(42, 98, 120))

When working with very large datasets, we need tools to help us get a sense of the dataset without having to load the entire data frame. For instance, we can view the first 6 rows of the dataset by calling head().

head(df)

dim() will tell us the dimensions of the data frame - i.e. the number of rows and the number of columns in the data frame.

dim(df)

“str()” provides a great deal of information about the observations in the data frame, including the number of variables, the number of observations, the variable names, their data types, and a list of observations.

str(df)

Just like as we had done with matrices, we can extract particular rows and columns in a data frame by referring to their indexes in brackets.

df[2,4]

We often don’t want to have the count the index of each column in order to refer to a particular variable in our dataframe. Instead, we can refer to the variable (column) name using the same “$” notation that we discussed above. For instance, I could see the values in the birth_month column by calling:

df$birth_month

If I wanted the extract the second observation in the birth_month, I would call:

df$birth_month[2]

What if you don’t know what the column names are? To see a list of column names, we could refer to the data dictionary. We could also use the function “colnames()”.

colnames(df)

Finally, on the top right hand side of your RStudio screen, you will see a tab called Environment. If you click on that tab, you should see all of the data that you have stored in variables. You can check column names here.

LS0tCnRpdGxlOiAiTGFiIDEgLSBJbnRyb2R1Y3Rpb24gdG8gUiIKb3V0cHV0OgogIGh0bWxfbm90ZWJvb2s6CiAgICB0b2M6IHllcwogICAgdG9jX2RlcHRoOiAzCiAgICB0b2NfZmxvYXQ6IHllcwogIGh0bWxfZG9jdW1lbnQ6CiAgICBkZl9wcmludDogcGFnZWQKICAgIHRvYzogeWVzCiAgICB0b2NfZGVwdGg6ICczJwplZGl0b3Jfb3B0aW9uczoKICBjaHVua19vdXRwdXRfdHlwZTogaW5saW5lCi0tLQoKIyMgSW5zdHJ1Y3Rpb25zIGFuZCBPdmVydmlldwoKV2VsY29tZSB0byB0aGUgRGF0YSBFdGhub2dyYXBoaWVzIExhYiBCb29rISBUb2dldGhlciwgdGhlIG5pbmUgbm90ZWJvb2tzIGluIHRoaXMgTGFiIEJvb2sgd2lsbCB3YWxrIHlvdSB0aHJvdWdoIGEgcmVzZWFyY2ggcHJvamVjdCBjb250ZXh0dWFsaXppbmcsIGV4cGxvcmluZywgYW5kIHZpc3VhbGl6aW5nIGEgcHVibGljbHktYWNjZXNzaWJsZSBkYXRhc2V0LiBFYWNoIG5vdGVib29rIHdpbGwgZGVtb25zdHJhdGUgaG93IHRvIGV4cGxvcmUgYSBkYXRhc2V0IGluIFIsIGFsb25nIHdpdGggbW9kZXMgb2YgY3JpdGljYWwgcmVmbGVjdGlvbiB0aGF0IGNhbiBoZWxwIHlvdSBldmFsdWF0ZSB0aGUgY29sbGVjdGl2ZSB2YWx1ZXMgYW5kIGNvbW1pdG1lbnRzIHRoYXQgc2hhcGUgZGF0YSBhbmQgdGhlIHN0b3JpZXMgaXQgY29udmV5cy4gTGFicyAyLTMgd2lsbCBpbnZvbHZlIHJlc2VhcmNoIHBsYW5uaW5nLCBkYXRhIGRpc2NvdmVyeSwgYW5kIGRhdGEgYmFja2dyb3VuZCByZXNlYXJjaC4gTGFicyA0LTcgd2lsbCBpbnZvbHZlIGRhdGEgZXhwbG9yYXRpb24sIGFuYWx5c2lzLCBhbmQgY3JpdGlxdWUuIEZpbmFsbHksIGxhYnMgOCBhbmQgOSB3aWxsIGludm9sdmUgc3VtbWFyaXppbmcgZmluZGluZ3MsIGRvY3VtZW50aW5nIGtub3dsZWRnZSBnYXBzLCBhbmQgcHJlc2VudGluZyB1bmNlcnRhaW50eS4gCgpBcyB3ZSBtb3ZlIHRocm91Z2ggdGhpcyBmaXJzdCBub3RlYm9vaywgd2Ugd2lsbCBiZWdpbiB0byBnZXQgYWNxdWFpbnRlZCB3aXRoIFIgTWFya2Rvd24gLSB0aGUgZm9ybWF0IGluIHdoaWNoIHRoZXNlIG5vdGVib29rcyBhcmUgd3JpdHRlbiAtLCB0aGUgdGhlbWVzIG9mIHRoZSBub3RlYm9va3MsIGFuZCB0aGUgc3RhdGlzdGljYWwgcHJvZ3JhbW1pbmcgbGFuZ3VhZ2UgUi4gSWYgeW91IGFyZSBoZXJlIGJlY2F1c2UgeW91IGFyZSBsb29raW5nIHRvIGJlY29tZSBhIHdoaXogYXQgc3RhdGlzdGljYWwgYW5hbHlzaXMgb3IgZGF0YSBzY2llbmNlLCB5b3Ugc2hvdWxkIGtub3cgdGhhdCB0aGlzIGlzIG5vdCB0aGUgcHJpbWFyeSBnb2FsIG9mIHRoZXNlIG5vdGVib29rcy4gSW5zdGVhZCwgdGhlIG5vdGVib29rcyBhcmUgZGVzaWduZWQgdG8gZW5jb3VyYWdlIHlvdSB0byB0aGluayBjcml0aWNhbGx5IGFib3V0IGEgZGF0YSBwcmFjdGljZSAtIHJlY29nbml6aW5nIHRoZSBodW1hbiBmb3JjZXMgdGhhdCBhcmUgYWx3YXlzIGludm9sdmVkIGluIHNoYXBpbmcgZGF0YSwgcmVzcG9uc2libHkgZG9jdW1lbnRpbmcgdW5jZXJ0YWludGllcyBpbiBkYXRhLCBhbmQgY29tbXVuaWNhdGluZyB3YXlzIHRoYXQgZGF0YSBjYW4gYm90aCBwcm9kdWNlIGFuZCBkZWxpbWl0IGluc2lnaHQuIFdoaWxlIGFuYWx5emluZyBkYXRhIGluIGFwcHJvcHJpYXRlIHdheXMgYXJlIGltcG9ydGFudCBwYXJ0cyBvZiBlYWNoIG5vdGVib29rLCB0aGUgcmVmbGVjdGlvbnMgdGhhdCB5b3Ugd2lsbCB3cml0ZSBhYm91dCB0aGUgYW5hbHlzZXMgeW91IHByb2R1Y2UgYXJlIHBlcmhhcHMgZXZlbiBtb3JlIGltcG9ydGFudC4gCgojIyBJbnRyb2R1Y3Rpb24gdG8gUlN0dWRpbwoKQXMgd2Ugd29yayB0aHJvdWdoIHRoZXNlIG5vdGVib29rcywgd2Ugd2lsbCBiZSBsZWFybmluZyBob3cgdG8gY29kZSBpbiBSIGluc2lkZSB0aGUgUlN0dWRpbyBpbnRlcmZhY2UuIFlvdSBtYXkgYmUgd29uZGVyaW5nIHRoZSBkaWZmZXJlbmNlIGJldHdlZW4gdGhlIHR3by4gCgoqKlIqKiBpcyBhIHN0YXRpc3RpY2FsIGNvbXB1dGluZyBsYW5ndWFnZSB0aGF0IGFsbG93cyB5b3UgdG86CiogU3RvcmUgZGF0YSBpbiBhIHZhcmlldHkgb2YgZm9ybWF0cwoqIFBlcmZvcm0gY2FsY3VsYXRpb25zIG9uIGRhdGEgYW5kIHZhcmlhYmxlcywgCiogQnVpbGQgZnVuY3Rpb25zIGFuZCBhcHBsaWNhdGlvbnMsIGFuZCAKKiBUcmFuc2Zvcm0gYW5kIGdyYXBoaWNhbGx5IHJlcHJlc2VudCBkYXRhCgoqKlJTdHVkaW8qKiBpcyBhbiBJbnRlZ3JhdGVkIERldmVsb3BtZW50IEVudmlyb25tZW50IChJREUpIGZvciBzdGF0aXN0aWNhbCBjb21wdXRpbmcuIEl0IGlzIGEgcGxhdGZvcm0gZm9yIHVzaW5nIGFuZCBjb2RpbmcgaW4gUi4KCkJlZm9yZSB3ZSBjb250aW51ZSwgcGxlYXNlIHdhdGNoIHRoaXMgOC1taW51dGUgdmlkZW8gaW50cm9kdWNpbmcgeW91IHRvIHRoZSBSU3R1ZGlvIEVudmlyb25tZW50LiAKCjxpZnJhbWUgd2lkdGg9IjU2MCIgaGVpZ2h0PSIzMTUiIHNyYz0iaHR0cHM6Ly93d3cueW91dHViZS5jb20vZW1iZWQvVEptTnZmaExDb0kiIGZyYW1lYm9yZGVyPSIwIiBhbGxvd2Z1bGxzY3JlZW4+PC9pZnJhbWU+CgojIyMgSW5zdGFsbGluZyBQYWNrYWdlcwoKVGhlIFIgY29tbXVuaXR5IGhhcyBkZXZlbG9wZWQgYSBzZXJpZXMgb2YgKnBhY2thZ2VzKiBvciBjb2xsZWN0aW9ucyBvZiBmdW5jdGlvbnMgdGhhdCB3ZSBjYW4gdXNlIHdoZW4gY29kaW5nIGluIFIuIFdlIHdpbGwgYmUgbGV2ZXJhZ2luZyBhIHNlcmllcyBvZiBwYWNrYWdlcyBrbm93biBhcyB0aGUgVGlkeXZlcnNlIC0gZGVzaWduZWQgdG8gaGVscCB1c2VycyBjbGVhbiwgdHJhbnNmb3JtLCBhbmFseXplLCBhbmQgdmlzdWFsaXplIGRhdGEuIFlvdSB3aWxsIG5lZWQgdG8gaW5zdGFsbCB0aGUgZm9sbG93aW5nIHBhY2thZ2VzIGluIHlvdXIgUiBlbnZpcm9ubWVudC4gVG8gZG8gc28sIHlvdSBzaG91bGQgY29weSBhbmQgcGFzdGUgdGhlIGZvbGxvd2luZyBsaW5lIGludG8geW91ciBDb25zb2xlLiBJZiB5b3UgZG9uJ3Qga25vdyB3aGVyZSB5b3UgY29uc29sZSBpcywgYmUgc3VyZSB0byByZXdhdGNoIHRoZSBSU3R1ZGlvIFlvdVR1YmUgdmlkZW8gYWJvdmUuIAoKaW5zdGFsbC5wYWNrYWdlcyhjKCJ0aWR5dmVyc2UiLCAibHVicmlkYXRlIiwgInJtYXJrZG93biIsICJsZWFmbGV0IikpCgpPbmNlIHBhY2thZ2VzIGFyZSBpbnN0YWxsZWQsIHRvIGxvYWQgdGhlIHBhY2thZ2UsIHdlIGNhbGwgdGhlIGZ1bmN0aW9uICpsaWJyYXJ5KCkqLCB3aGljaCBsZXQncyBSIGtub3cgdGhhdCB3ZSB3aWxsIGJlIHJlZmVyZW5jaW5nIHRoZSBmdW5jdGlvbnMgZW5jb2RlZCBmb3IgdGhpcyBwYWNrYWdlIGluIG91ciBjb2RlLiBZb3UgY2FuIHRoaW5rIG9mIGFuIFIgcGFja2FnZSBsaWtlIGEgYm9vaywgc3RvcmVkIGluIGEgY29tcHV0ZXIgbGlicmFyeS4gV2hlbiB5b3UgY2FsbCwgbGlicmFyeSgpLCBpdCBpcyBhcyBpZiB3ZSBhcmUgY2hlY2tpbmcgdGhhdCBib29rIG91dCBvZiB0aGUgbGlicmFyeSBzbyB0aGF0IHdlIG1heSByZWZlcmVuY2UgaXRzIGZ1bmN0aW9ucyBpbiBvdXIgY29kZS4gUnVuIHRoZSBjb2RlIGJlbG93IGFmdGVyIGluc3RhbGxpbmcgdGhlIHBhY2thZ2VzIGFib3ZlIHRvIGVuc3VyZSB0aGF0IGV2ZXJ5dGhpbmcgaW5zdGFsbGVkIHByb3Blcmx5LiBSZWZlciB0byB0aGUgdmlkZW8gYWJvdmUgaWYgeW91IGRvIG5vdCBrbm93IGhvdyB0byBydW4gdGhlIGNvZGUuIAoKYGBge3J9CmxpYnJhcnkodGlkeXZlcnNlKQpsaWJyYXJ5KGx1YnJpZGF0ZSkKbGlicmFyeShybWFya2Rvd24pCmxpYnJhcnkobGVhZmxldCkKYGBgCgojIyBJbnRyb2R1Y3Rpb24gdG8gUiBNYXJrZG93bgoKSWYgeW91IGFyZSB2aWV3aW5nIHRoaXMgZG9jdW1lbnQgaW4gUlN0dWRpbywgeW91J2xsIG5vdGljZSBhIHNlcmllcyBvZiBjaGFyYWN0ZXJzIChsaWtlIGhhc2h0YWdzIGFuZCBhc3Rlcmlza3MpIGJlaW5nIHVzZWQgdG8gZGVtYXJjYXRlIGhlYWRlcnMsIGNvZGUgY2h1bmtzLCBpdGFsaWNpemVkIGFuZCBlbXBoYXNpemVkIHdvcmRzLCBidWxsZXRzLCBudW1iZXJpbmcsIGZpZ3VyZXMsIGFuZCB0YWJsZXMuIFRoZXNlIGNoYXJhY3RlcnMgYXJlIGVuY29kaW5nIGhvdyB0aGUgZG9jdW1lbnQgc2hvdWxkIGJlIHByZXNlbnRlZCB3aGVuIHdlIHB1Ymxpc2ggaXQuIFRoZXNlIHN5bWJvbHMgYXJlIHBhcnQgb2YgUiBNYXJrZG93biAtIGFuIGF1dGhvcmluZyBmcmFtZXdvcmsgZm9yIFIgdGhhdCBlbmFibGVzIHVzIHRvIHN0eWxlIGRvY3VtZW50cyBhbmQgZW1iZWQgY29kZS4gV2hlbiB3ZSBwdWJsaXNoIHRoaXMgZG9jdW1lbnQsIHlvdSBzZWUgdGhlIHRleHQgZm9sbG93aW5nIG9yIGluIGJldHdlZW4gdGhlc2Ugc3ltYm9scyBmb3JtYXR0ZWQgaW4gYSBzdGFuZGFyZGl6ZWQgd2F5LiBJZiB5b3Ugd291bGQgbGlrZSB0byBzZWUgaG93IHRoaXMgZG9jdW1lbnQgd2lsbCBhcHBlYXIgb25jZSBpdCdzIHB1Ymxpc2hlZCwgY2xpY2sgdGhlICdQcmV2aWV3JyBidXR0b24gaW4gdGhlIG5hdmlnYXRpb24gYmFyIGFib3ZlLiBUaGlzIHdpbGwgcHJldmlldyB0aGUgcHVibGlzaGVkIGRvY3VtZW50IGluIHRoZSBWaWV3ZXIgdG8gdGhlIHJpZ2h0LiAKCkhlcmUgYXJlIHNvbWUgY29tcG9uZW50cyBvZiBSIE1hcmtkb3duIHRoYXQgeW91IG1heSBzZWUgdGhyb3VnaG91dCB0aGUgbm90ZWJvb2tzLiAKCiMjIyBDb2RlIENodW5rcwoKYGBge3IgZXZhbD1GQUxTRX0KVGhpcyBncmV5IGJveCBiZXR3ZWVuIGBgYHtyfSBhbmQgYGBgIGlzIGEgY29kZSBjaHVuay4gCgpUeXBpY2FsbHksIHdoZW4gd2UgcHV0IGNvZGUgaW4gdGhpcyBjaHVuayBhbmQgdGhlbiBwdWJsaXNoIG91ciBSIE1hcmtkb3duIGRvY3VtZW50LCAKdGhlIGNvZGUgd3JpdHRlbiBoZXJlIHdpbGwgYmUgcnVuIGFuZCBvdXRwdXQgb24gdGhlIHNjcmVlbi4gCgpIb3dldmVyLCBieSBwbGFjaW5nIGV2YWw9RkFMU0UgaW4gdGhlIGJyYWNrZXRzLCB3ZSB0ZWxsIFIgbm90IHRvIGV2YWx1YXRlIHRoZSBjb2RlLiAKClRoaXMgaXMgdXNlZnVsIHdoZW4gd2UgYXJlIGp1c3QgZmlsbGluZyB0ZXh0IGludG8gdGhlIGNvZGUgY2h1bmsuCmBgYAoKIyMjIEhlYWRpbmdzCgoKVXNlICcjJyB0byBjcmVhdGUgaGVhZGluZ3M6CiAgCiMgSGVhZGluZyAxCiMjIEhlYWRpbmcgMgojIyMgSGVhZGluZyAzCgoKIyMjIFRhYmxlcwoKClRhYmxlcyBjYW4gYmUgZm9ybWF0ZWQgbGlrZSB0aGlzOgoKSGVhZGVyIDEgfCBIZWFkZXIgMQotLS0tLS0tLSB8IC0tLS0tLS0tCkNlbGwgMSAgfCBDZWxsIDIKQ2VsbCAzICB8IENlbGwgNAoKIyMjIEJ1bGxldHMgYW5kIE51bWJlcmluZwoKCllvdSBjYW4gYnVsbGV0IGNvbnRlbnQgdXNpbmcgdGhlICcqJzoKCiogUG9pbnQgMQoqIFBvaW50IDIKCgpZb3UgY2FuIG51bWJlciBjb250ZW50IGxpa2UgdGhpczoKCjEuIFBvaW50IDEKMi4gUG9pbnQgMgoKCkZvciBtb3JlIGluZm9ybWF0aW9uIGFib3V0IGZvcm1hdHRpbmcgZG9jdW1lbnRzIGluIFIgTWFya2Rvd24gc2VlIFt0aGlzXShodHRwczovL3JzdHVkaW8uY29tL3dwLWNvbnRlbnQvdXBsb2Fkcy8yMDE1LzAyL3JtYXJrZG93bi1jaGVhdHNoZWV0LnBkZikgY2hlYXRzaGVldC4gTm90ZSBob3cgSSBjcmVhdGVkIGEgaHlwZXJsaW5rIGhlcmUhCgojIyBMYWIgQm9vayBUaGVtZXMKCk9uIE1hcmNoIDMwLCAyMDIwLCBOYXRlIFNpbHZlciAtIHdobyBoYWQgYmVlbiB2b2NpZmVyb3VzbHkgdm9jYWwgaW4gc2hhcmluZyBoaXMgaW5zaWdodHMgaW50byBkYXRhIHJlZ2FyZGluZyB0aGUgQ292aWQtMTkgcGFuZGVtaWMgLSB0d2VldGVkIG91dCB0byBoaXMgbmV0d29ya3M6Cgo8YmxvY2txdW90ZSBjbGFzcz0idHdpdHRlci10d2VldCI+PHAgbGFuZz0iZW4iIGRpcj0ibHRyIj5Eb24mIzM5O3QgbWFrZSBwcmV0dHkgZ3JhcGhzIHdpdGggdGhlIGRhdGEgZWl0aGVyLiBUaGF0IGp1c3Qgb2JzY3VyZXMgaG93IG1lc3N5IGl0IGlzLjwvcD4mbWRhc2g7IE5hdGUgU2lsdmVyIChATmF0ZVNpbHZlcjUzOCkgPGEgaHJlZj0iaHR0cHM6Ly90d2l0dGVyLmNvbS9OYXRlU2lsdmVyNTM4L3N0YXR1cy8xMjQ0NjgxNzQyMTY4MDEwNzU1P3JlZl9zcmM9dHdzcmMlNUV0ZnciPk1hcmNoIDMwLCAyMDIwPC9hPjwvYmxvY2txdW90ZT4gPHNjcmlwdCBhc3luYyBzcmM9Imh0dHBzOi8vcGxhdGZvcm0udHdpdHRlci5jb20vd2lkZ2V0cy5qcyIgY2hhcnNldD0idXRmLTgiPjwvc2NyaXB0PgoKVGhlIHR3ZWV0IHJlYWxseSBuaWNlbHkgc3VtcyB1cCBhbiBvdmVycmlkaW5nIHRoZW1lIG9mIHRoZXNlIExhYiBCb29rcy4gV2UgY2FuIGxlYXJuIGFsbCBzb3J0cyBvZiB0ZWNobmlxdWVzIHRvIHByb2R1Y2UgYmVhdXRpZnVsIGNoYXJ0cywgdGFibGVzLCBhbmQgdmlzdWFsaXphdGlvbnMgd2l0aCBkYXRhLiBCdXQgd2hlbiB3ZSBhcmUgZGVhbGluZyB3aXRoIG1lc3N5LCBjb21wbGV4LCBhbmQgZHluYW1pYyBwaGVub21lbmEsIHN1Y2ggdGVjaG5pcXVlcyBjYW4gaGlkZSBqdXN0IGhvdyBtdWNoIHVuY2VydGFpbnR5IHRoZXJlIGlzIGluIGRhdGEgYW5kIGp1c3QgaG93IG11Y2ggc2l0dWF0ZWQgaHVtYW4gcGVyc3BlY3RpdmUgaXMgaW50ZXJ3b3ZlbiB0aHJvdWdoIG51bWVyaWMgY2FsY3VsYXRpb25zLiBUaGlzIExhYiBCb29rIGlzIGRlc2lnbmVkIHRvIGVuY291cmFnZSB5b3UgdG8gYWx3YXlzIGtlZXAgdGhlc2UgaXNzdWVzIGluIG1pbmQgYXMgeW91IGVuZ2FnZSBpbiBkYXRhIGFuYWx5c2lzLiAKCkRvIHdlIGFsbCBrbm93IHdobyBOYXRlIFNpbHZlciBpcz8gTmF0ZSBTaWx2ZXIgZ2FpbmVkIG5vdG9yaWV0eSBmb2xsb3dpbmcgdGhlIDIwMDggVVMgcHJlc2lkZW50aWFsIGVsZWN0aW9uLCB3aGVuIGhlIGZpcnN0IGFjY3VyYXRlbHkgcHJlZGljdGVkIHRoZSByZXN1bHRzIG9mIDQ5IG9mIHRoZSA1MCBzdGF0ZXMuIEJ5IHRoZSAyMDEyIGVsZWN0aW9uLCBoaXMgZGF0YSBoYWQgYWNjdXJhdGVseSBwcmVkaWN0ZWQgdGhlIHJlc3VsdHMgb2YgYWxsIDUwIHN0YXRlcy4gSGlzIHdlYnNpdGUgRml2ZVRoaXJ0eUVpZ2h0LmNvbSB3YXMgcXVpY2tseSBhY3F1aXJlZCBieSB0aGUgTmV3IFlvcmsgVGltZXMgYW5kIGxhdGVyIGJ5IEVTUE4gYW5kIHVzaGVyZWQgaW4gYSBuZXcgd2F2ZSBvZiB3b3JrIGF0IHRoZSBpbnRlcnNlY3Rpb24gb2YgZGF0YSBzY2llbmNlIGFuZCBlbGVjdGlvbiBmb3JlY2FzdGluZy4gSG93ZXZlciwgTmF0ZSBTaWx2ZXIgaXMgd2VsbC1hY3F1YWludGVkIHdpdGggbWVzc3kgYW5kIHVuY2VydGFpbiBkYXRhLiBXaGlsZSBub25lIG9mIHRoZSBtYWpvciBwb2xsaW5nIHNpdGVzIHdlcmUgYWJsZSB0byBhY2N1cmF0ZWx5IHByZWRpY3QgdGhlIHJlc3VsdHMgb2YgdGhlIDIwMTYgVVMgcHJlc2lkZW50aWFsIGVsZWN0aW9uLCBGaXZlVGhpcnR5RWlnaHQncyBwcmVkaWN0aW9ucyAod2hpbGUgcGxhY2luZyB0aGUgY2hhbmNlcyBvZiBhIFRydW1wIHZpY3RvcnkgaGlnaGVyIHRoYW4gb3RoZXIgbmV3cyBzb3VyY2VzKSB3ZXJlIHBlcmhhcHMgbW9zdCBzdXJwcmlzaW5nIGZvbGxvd2luZyBoaXMgc3VjY2VzcyBpbiBwcmV2aW91cyBlbGVjdGlvbnMuIEJ5IGVsZWN0aW9uIGRheSwgRml2ZVRoaXJ0eUVpZ2h0IGhhZCBwbGFjZWQgdGhlIGxpa2VsaWhvb2Qgb2YgYSBDbGludG9uIHZpY3RvcnkgYXQgNzAlLiBJIHJlbWVtYmVyIHdhdGNoaW5nIHRoZSBuZXdzIG9uIGVsZWN0aW9uIG5pZ2h0IGFuZCwgYXMgYW4gYW50aHJvcG9sb2dpc3Qgb2YgZGF0YSwgYWxtb3N0IGZhbGxpbmcgb3V0IG9mIG15IGNoYWlyIHdoZW4gSSBoZWFyZCBwb2xpdGljYWwgY29ycmVzcG9uZGVudCBNaWtlIE11cnBoeSBjbGFpbSB0aGF0ICJUb2RheSwgZGF0YSBraW5kIG9mIGRpZWQuIiBXYXRjaCB0aGUgY2xpcCBiZWxvdzoKCjxpZnJhbWUgd2lkdGg9IjU2MCIgaGVpZ2h0PSIzMTUiIHNyYz0iaHR0cHM6Ly93d3cueW91dHViZS5jb20vZW1iZWQvTWhUNXFUMTE2d28iIGZyYW1lYm9yZGVyPSIwIiBhbGxvd2Z1bGxzY3JlZW4+PC9pZnJhbWU+CgpBbiBpbXBvcnRhbnQgbGVzc29uIHRoYXQgZW1lcmdlZCBmcm9tIHRoaXMgaW5jcmVkaWJsZSBkYXRhIGZsb3AgaXMganVzdCBob3cgaW1wb3J0YW50IGl0IGlzIHRvIGJlIGJlIGFibGUgdG8gY3JpdGlxdWUgb3VyIGRhdGEgbGFuZHNjYXBlIC0gdG8gcXVlc3Rpb24gd2hhdCBkYXRhIGlzIGF2YWlsYWJsZSBhbmQgd2hhdCBkYXRhIGlzIG5vdCBhdmFpbGFibGUsIHRvIGNvbnNpZGVyIGhvdyByZXByZXNlbnRhdGl2ZSBkYXRhIG1heSBiZSBvZiBjb21wbGV4IGlzc3VlcywgYW5kIHRvIGFja25vd2xlZGdlIGFuZCBjb21tdW5pY2F0ZSBkYXRhIHVuY2VydGFpbnRpZXMuIFRoZSAyMDE2IHBvbGxzIGZhaWxlZCB0byBjb25zaWRlciBhIG51bWJlciBvZiB0aGluZ3MuIFdoaWxlIHdpZGVzcHJlYWQgcG9sbGluZyBoYWQgYmVlbiB0YWtpbmcgdGhlIHB1bHNlIG9mIHRoZSBjb3VudHJ5IGluIHRoZSBtb250aHMgbGVhZGluZyB1cCB0byB0aGUgZWxlY3Rpb24sIHBvbGxzdGVycyB1bmRlcmVzdGltYXRlZCB0aGUgaW1wYWN0IHRoYXQgdm90ZXJzIHVuZGVjaWRlZCBhdCB0aGUgdGltZSBwb2xscyB3ZXJlIHRha2VuIGNvdWxkIGhhdmUgb24gdGhlIG92ZXJhbGwgcmVzdWx0cy4gVGhleSBmYWlsZWQgdG8gYWNjb3VudCBmb3IgZGF0YSB1bmNlcnRhaW50eS4gRnVydGhlciwgbm90IGV2ZXJ5IHBlcnNvbiBpbiB0aGUgY291bnRyeSBpcyBwb2xsZWQgbGVhZGluZyB1cCB0byB0aGUgZWxlY3Rpb24uIFdoZW4gZGV0ZXJtaW5pbmcgd2hvIHRvIHBvbGwsIHBvbGxzdGVycyBkZXZpc2UgInJlcHJlc2VudGF0aXZlIHNhbXBsZXMiIG9mIHRoZSBwb3B1bGF0aW9uIC0gcmVhY2hpbmcgb3V0IHRvIGxpa2VseSB2b3RlcnMgaW4gZGl2ZXJzZSBhZ2UgYnJhY2tldHMsIHdpdGggZGl2ZXJzZSBpbmNvbWUgbGV2ZWxzLCBhbmQgd2l0aCBkaXZlcnNlIGVkdWNhdGlvbmFsIGJhY2tncm91bmRzLiBUaGV5IGhhdmUgdG8gbWFrZSBhIGxvdCBvZiBhc3N1bXB0aW9ucyBhYm91dCB0aGUgY29tcG9zaXRpb24gb2YgdGhlIGNvdW50cnkgd2hlbiBjb21pbmcgdXAgd2l0aCB0aGVzZSBzYW1wbGUgLSBvZnRlbiByZWx5aW5nIG9uIGhvdyBlbGVjdGlvbnMgcGxheWVkIG91dCBpbiB0aGUgcGFzdCwgYWxvbmcgd2l0aCB3aGF0IGhhcyBjdWx0dXJhbGx5IGNoYW5nZWQgc2luY2UgcGFzdCBlbGVjdGlvbnMsIHRvIHByZWRpY3QgaG93IHRoZXkgd2lsbCBwbGF5IG91dCBpbiB0aGUgZnV0dXJlLiBJbiAyMDE2LCBtYW55IG9mIHRoZWlyIGFzc3VtcHRpb25zIGFib3V0IHRoZSBjb3VudHJ5J3MgY29tcG9zaXRpb24gd2VyZSB3cm9uZy4gCgpBcyBzdGF0aXN0aWNpYW5zIHR1cm4gdGhlaXIgYXR0ZW50aW9uIHRvIHRoZSBjdXJyZW50IHB1YmxpYyBoZWFsdGggY3Jpc2lzIGFyb3VuZCBDb3ZpZC0xOSwgc3VjaCBjb25zaWRlcmF0aW9ucyBzaG91bGQgYmUgYXQgdGhlIGZvcmVmcm9udCBvZiBvdXIgbWluZHMuIEFzIHdlIHdpbGwgc2VlIHRocm91Z2hvdXQgdGhlc2Ugbm90ZWJvb2tzLCB0aGUgZGF0YSB0aGF0IHdlIGhhdmUgYWJvdXQgQ292aWQtMTkgaXMgaW5jcmVkaWJseSBtZXNzeSBhbmQgcmlkZGxlZCB3aXRoIGluY29uc2lzdGVuY2llcy4gRGF0YSBzY2llbnRpc3RzIGFuZCBpbnRlcm5hdGlvbmFsIG9yZ2FuaXphdGlvbnMgaGF2ZSBoYWQgdG8gdmVyeSBxdWlja2x5IGFnZ3JlZ2F0ZSBkYXRhIGZyb20gYWxsIGNvcm5lcnMgb2YgdGhlIHdvcmxkIC0gY29sbGVjdGluZyBjYXNlIGNvdW50cyBmcm9tIGNvdW50cmllcyB3aXRoIGRpZmZlcmVudCBtZWRpY2FsIHN5c3RlbXMsIGRpZmZlcmVudCBzdGFuZGFyZHMgZm9yIG1lZGljYWwgZGF0YSByZXBvcnRpbmcsIGFuZCBkaWZmZXJlbnQgcG9saXRpY3MuIFRoZXNlIGNvdW50cmllcyB0aGVtc2VsdmVzIGFyZSB0cnlpbmcgdG8gZmlndXJlIG91dCBob3cgdG8gZ2F0aGVyIHRoaXMgZGF0YSBmcm9tIHN0YXRlcyBhbmQgcHJvdmluY2VzLCBhbmQgc3RhdGVzIGFuZCBwcm92aW5jZXMgdGhlbXNlbHZlcyBhcmUgdHJ5aW5nIHRvIGZpZ3VyZSBvdXQgaG93IHRvIGdhdGhlciB0aGlzIGRhdGEgZnJvbSBob3NwaXRhbHMuIFRoZSBjb29yZGluYXRpb25hbCBjYXBhY2l0eSBuZWVkZWQgdG8gcHJvZHVjZSB0aGUgbnVtYmVycyB0aGF0IHdlIGV2ZW50dWFsbHkgc2VlIGlzIGVub3Jtb3VzLCBkZW1hbmRpbmcgY29uc2lkZXJhYmxlIGdsb2JhbCBpbmZvcm1hdGlvbiBpbmZyYXN0cnVjdHVyZS4KCkZ1cnRoZXIsIGFzIHdlIHdpbGwgY29uc2lkZXIgYWdhaW4gYW5kIGFnYWluIHRocm91Z2hvdXQgdGhlIG5vdGVib29rcywgdGhlIGNhc2UgY291bnQgZGF0YSB0aGF0IHdlIGhhdmUgaXMgb25seSBhcyBnb29kIGFzIHRoZSBhbW91bnQgb2YgdGVzdGluZyBmb3IgdGhlIHZpcnVzIHRoYXQgaXMgdGFraW5nIHBsYWNlLCBhbmQgaW4gbWFueSBjb3VudHJpZXMsIGluY2x1ZGluZyB0aGUgVVMsIHRlc3RpbmcgaGFzIGJlZW4gaW5jcmVkaWJseSBzbG93LiBUaGlzIGd1YXJhbnRlZXMgdGhhdCBjYXNlIGNvdW50cyB3aWxsIGJlIHVuZGVyLXJlcG9ydGVkLiBUaGVzZSBhcmUgdGhlIHR5cGVzIG9mIGlzc3VlcyBOYXRlIFNpbHZlciBpcyByZWZlcnJpbmcgdG8gd2hlbiBoZSB0ZWxscyB0aGUgd29ybGQgdG8gc3RvcCB0cnlpbmcgdG8gcHJvZHVjZSBwcmV0dHkgZ3JhcGhzIG9mIHRoZSBzcHJlYWQuIAoKIyMgRXRobm9ncmFwaHkKCkV2ZXJ5IGRpc2NpcGxpbmUgaGFzIGEgc2V0IG9mIG1ldGhvZHMgdGhhdCB0aGV5IGxldmVyYWdlIHRvIGFkdmFuY2UgcmVzZWFyY2ggaW4gdGhlaXIgZmllbGRzLiBEaXNjaXBsaW5hcnkgcmVzZWFyY2ggbWV0aG9kcyByZWZlciB0byB0aGUgdGVjaG5pcXVlcyBhbmQgcHJhY3RpY2VzIGEgcGFydGljdWxhciBkaXNjaXBsaW5lIGVuZ2FnZXMgaW4gb3JkZXIgdG8gZ2F0aGVyIGRhdGEsIGFuYWx5emUgZXZpZGVuY2UsIGFuZCBkZWVwZW4ga25vd2xlZGdlIG9uIGEgcGFydGljdWxhciB0b3BpYy4gRm9yIGNoZW1pc3RzLCBzdWNoIG1ldGhvZHMgbWlnaHQgaW5jbHVkZSBleHBlcmltZW50YXRpb24gYW5kIG9ic2VydmF0aW9uLiBGb3IgcHN5Y2hvbG9naXN0cywgc3VjaCBtZXRob2RzIG1pZ2h0IGluY2x1ZGUgY2FzZSBzdHVkaWVzIGFuZCBuZXVyby1pbWFnaW5nLiBJJ20gYW4gYW50aHJvcG9sb2dpc3QsIGFuZCBpbiBhbnRocm9wb2xvZ3ksIG9uZSBvZiBvdXIga2V5IG1ldGhvZHMgaXMga25vd24gYXMgZXRobm9ncmFwaHkuIAoKRXRobm9ncmFwaHkgaXMgdGhlIHByYWN0aWNlIG9mIHN0dWR5aW5nIHBlb3BsZSBhbmQgY3VsdHVyZXMuIFRvIGRvIHNvLCBldGhub2dyYXBoZXJzIG1heSBvYnNlcnZlIHBlb3BsZSBhcyB0aGV5IGludGVyYWN0IGluLCBtb3ZlIHRocm91Z2gsIG9yIG1ha2UgZGVjaXNpb25zIHdpdGhpbiBhIHBhcnRpY3VsYXIgc3BhY2UuIEFsdGVybmF0aXZlbHksIHRoZXkgbWF5IGludGVydmlldyBwZW9wbGUsIGVsaWNpdGluZyBuYXJyYXRpdmVzIGFib3V0IHdoYXQgdGhleSBmaW5kIGltcG9ydGFudCwgaG93IHRoZXkgdGhpbmsgYWJvdXQgdGhlIHdvcmxkLCBhbmQgaG93IHRoZWlyIHBlcnNvbmFsIGJhY2tncm91bmRzIGhhdmUgbW90aXZhdGVkIHRoZWlyIGN1cnJlbnQgY29tbWl0bWVudHMuIEltcG9ydGFudGx5LCBldGhub2dyYXBoeSBpcyBvZnRlbiBpbW1lcnNpdmU7IGV0aG5vZ3JhcGhlcnMgZGVlcGx5IGVuZ2FnZSBpbiBhIHBhcnRpY3VsYXIgc3BhY2UsIGdhdGhlcmluZyBhcyBtdWNoIGRldGFpbCBhcyB0aGV5IGNhbiAoYW5kIG9mdGVuIG1vcmUgZGV0YWlsIHRoYW4gdGhleSBrbm93IHdoYXQgdG8gZG8gd2l0aCkgaW4gb3JkZXIgdG8gbGF0ZXIgYW5hbHl6ZSBhbmQgcmVsYXkgaG93IGN1bHR1cmFsIGZvcmNlcyBhcmUgb3BlcmF0aW5nIHdpdGhpbiBpdC4KCkluIHRoaXMgTGFiIEJvb2ssIHdlIGFyZSBnb2luZyB0byBjb25kdWN0IGFuIGV0aG5vZ3JhcGh5IG9mIGEgZGF0YXNldC4gWW91IG1heSBiZSBhc2tpbmcgLSBpZiBldGhub2dyYXBoeSBpcyBhYm91dCBzdHVkeWluZyBwZW9wbGUsIHdoeSBhcmUgd2UgdXNpbmcgaXQgdG8gc3R1ZHkgYSBkYXRhc2V0PyBUaGUgcmVhc29uIGZvciB0aGlzIGlzIHRoYXQsIGluIHRoZXNlIG5vdGVib29rcywgd2UgYXJlIHRha2luZyBhcyBhIGdpdmVuIHRoYXQgYWxsIGRhdGEgaGFzIGluIGNlcnRhaW4gd2F5cyBiZWVuIHNoYXBlZCBieSBodW1hbiBhc3N1bXB0aW9ucywganVkZ21lbnRzLCBhbmQgcG9saXRpY3MuIExldCBtZSBwcm92aWRlIGFuIGV4YW1wbGU6CgpUaGUgbGFzdCB0aW1lIEkgcmFuIHRoaXMgY291cnNlLCBvbmUgc3R1ZGVudCBzcGVudCB0aGUgcXVhcnRlciBzdHVkeWluZyBhIGRhdGFzZXQgZG9jdW1lbnRpbmcgdGhlIHBlcmltZXRlcnMgb2YgZWFjaCBkb2N1bWVudGVkIHdpbGRmaXJlIGluIENhbGlmb3JuaWEgc2luY2UgMTkwMC4gRWFjaCByb3cgaW4gdGhlIGRhdGFzZXQgZG9jdW1lbnRlZCBhIGZpcmUgbmFtZSwgdGhlIGRhdGUgdGhlIGZpcnN0IGFsYXJtIHdhcyBzb3VuZGVkLCB0aGUgZGF0ZSBpdCB3YXMgY29udGFpbmVkLCBhbmQgdGhlIGFjcmVhZ2UgdGhhdCBpdCBidXJuZWQuIEVhY2ggZmlyZSB3YXMgYWxzbyBjbGFzc2lmaWVkIHdpdGggYSBzdGFuZGFyZGl6ZWQgbGlzdCBvZiBmaXJlICJjYXVzZXMuIiAgVGhpcyBsaXN0IGluY2x1ZGVkIGNhdXNlcyBsaWtlICJDYW1wZmlyZSwiICJBcnNvbiwiIGFuZCAiTGlnaHRuaW5nLiIgVGhlIHN0dWRlbnQgY3JlYXRlZCB2aXN1YWxpemF0aW9ucyBvZiB0aGUgbnVtYmVyIG9mIGRvY3VtZW50ZWQgZmlyZXMgaW4gQ2FsaWZvcm5pYSB0aGF0IGhhZCBiZWVuIHRoZSByZXN1bHQgb2YgZWFjaCBjYXVzZS4gSW4gZG9pbmcgc28sIHNoZSBmb3VuZCBzb21ldGhpbmcgb2RkIC0gdGhlIGNhdXNlIG9mIHRoZSBmZXdlc3QgZmlyZXMgaW4gQ2FsaWZvcm5pYSB3ZXJlIGNvbGxlY3RpdmVseSBjYXRlZ29yaXplZCBhcyAiSWxsZWdhbCBBbGllbiBDYW1wZmlyZXMuIiAKCmBgYHtyIGZpZy5oZWlnaHQ9MywgZmlnLndpZHRoPTV9CmZpcmVzIDwtIHJlYWQuY3N2KCJodHRwczovL3Jhdy5naXRodWJ1c2VyY29udGVudC5jb20vbGluZHNheXBvaXJpZXIvU1RTLTExNS9tYXN0ZXIvZGF0YXNldHMvRmlyZXNfMTAwLmNzdiIsIHN0cmluZ3NBc0ZhY3RvcnMgPSBGQUxTRSkKZmlyZXMgJT4lIAogIGdncGxvdChhZXMoeCA9IHJlb3JkZXIoQ0FVU0UsQ0FVU0UsCiAgICAgICAgICAgICAgICAgICAgIGZ1bmN0aW9uKHgpLWxlbmd0aCh4KSksIGZpbGwgPSBDQVVTRSkpICsKICBnZW9tX2JhcigpICsKICBsYWJzKHRpdGxlID0gIkNvdW50IG9mIENhbEZJUkUtZG9jdW1lbnRlZCBXaWxkZmlyZXMgc2luY2UgMTg3OCBieSBDYXVzZSIsIHggPSAiQ2F1c2UiLCB5ID0gIkNvdW50IG9mIFdpbGRmaXJlcyIpICsgCiAgdGhlbWVfbWluaW1hbCgpICsKICB0aGVtZShsZWdlbmQucG9zaXRpb24gPSAibm9uZSIsIAogICAgICAgIHBsb3QudGl0bGUgPSBlbGVtZW50X3RleHQoc2l6ZSA9IDEyLCBmYWNlID0gImJvbGQiKSkgKwogIGNvb3JkX2ZsaXAoKSAKYGBgCgpXZSBpbW1lZGlhdGVseSBmbGFnZ2VkIHRoaXMuIFdoeSBkaWQgdGhpcyBjbGFzc2lmaWNhdGlvbiBleGlzdCBhcyBpdHMgb3duIHNlcGFyYXRlIGNhdGVnb3J5PyBXaHkgd2FzIGl0IG5vdCBlbm91Z2ggdG8gY2xhc3NpZnkgdGhlc2UgZmlyZXMgYXMgIkNhbXBmaXJlcyIgLSBhbm90aGVyIGNhdXNlIGNvZGUgaW4gdGhlIGRhdGFzZXQ/ICBUaGlzIGNvbW11bmljYXRlZCB0byB1cyB0aGF0IGF0IGEgcGFydGljdWxhciBwb2ludCBpbiB0aW1lLCBhIGdvdmVybmluZyBib2R5IGluIENhbGlmb3JuaWEgZGVlbWVkIGl0IGFwcHJvcHJpYXRlIHRvIGNvdW50IGlsbGVnYWwgYWxpZW4gY2FtcGZpcmVzIGZpcmVzIHNlcGFyYXRlbHkgLSBwcm9kdWNpbmcgYSBzZXQgYSBudW1iZXJzIGFuZCB2YWx1ZXMgdGhhdCB0ZWxsIGEgZGlmZmVyZW50IHN0b3J5IHRoYW4gdGhlIG9uZSB0aGF0IHdvdWxkIGhhdmUgYmVlbiBwcm9kdWNlZCBoYWQgYWxsICJjYW1wZmlyZXMiIGJlZW4gbHVtcGVkIHRvZ2V0aGVyLiAgSW4gdGhpcyBjYXNlLCB3ZSBuZWVkZWQgdG8gbG9vayBiZXlvbmQgdGhlIG51bWJlcnMgcmVwb3J0ZWQgaW4gb3JkZXIgdG8gbWFrZSBzZW5zZSBvZiB3aGF0IHdlIHdlcmUgc2VlaW5nIGluIGhlciBhbmFseXNpcyAtIHRha2luZyBpbnRvIGNvbnNpZGVyYXRpb24gaG93IGNlcnRhaW4gcG9saXRpY3Mgd2VyZSBhdCB3b3JrIGluIHNoYXBpbmcgd2hhdCB3ZSB3ZXJlIHNlZWluZy4gVGhpcyBvcGVuZWQgdXAgZXZlbiBtb3JlIHF1ZXN0aW9ucy4gV2hhdCBjb3VudHMgYXMgYSB3aWxkZmlyZSBhbnl3YXlzPyBXaG8gZ2V0cyB0byBkZWNpZGU/CgpXaGVuIHdlIGV0aG5vZ3JhcGhpY2FsbHkgYW5hbHl6ZSBhIGRhdGFzZXQgLSBpbW1lcnNpbmcgb3Vyc2VsdmVzIGluIGl0IHRvIGludmVzdGlnYXRlIHRoZSBjdWx0dXJhbCBmb3JjZXMgYXQgcGxheSAtIHdlIGNhbiBwdWxsIHN1Y2ggbmFycmF0aXZlcyB0byB0aGUgZm9yZS4gQWNjb3JkaW5nbHksIGluIHRoZXNlIG5vdGVib29rcywgd2UgYXJlIG5vdCBvbmx5IGdvaW5nIHRvIGNvbnNpZGVyIHdoYXQgcXVhbnRpdGF0aXZlIGluc2lnaHRzIHdlIGNhbiBleHRyYXBvbGF0ZSBmcm9tIGRhdGEuIFdlIGFyZSBhbHNvIGdvaW5nIHRvIGFuYWx5emUgdGhlIGRhdGEgZm9yIHdoYXQgaXQgdGVsbHMgdXMgYWJvdXQgY3VsdHVyZSAtIGhvdyBwZW9wbGUgcGVyY2VpdmUgZGlmZmVyZW5jZSBhbmQgYmVsb25naW5nLCBob3cgcGVvcGxlIHJlcHJlc2VudCBjb21wbGV4IGlkZWFzIG51bWVyaWNhbGx5LCBhbmQgaG93IHRoZXkgcHJpb3JpdGl6ZSBjZXJ0YWluIGZvcm1zIG9mIGtub3dsZWRnZSBvdmVyIG90aGVycy4KCiMjIEEgTm90ZSBvbiB0aGUgV29yZCBCaWFzCgpTb21lIG9mIHlvdSBtYXkgYmUgdGhpbmtpbmcgLSBpZiB0aGVyZSBhcmUgaHVtYW4gcGVyc3BlY3RpdmVzIHNoYXBpbmcgZGF0YSwgZG9lc24ndCB0aGF0IG1ha2UgaXQgYmlhc2VkPyAKClRoZSBPeGZvcmQgRW5nbGlzaCBEaWN0aW9uYXJ5IGRlZmluZXMgYmlhcyBhczoKCj4gIkFuIGluY2xpbmF0aW9uLCBsZWFuaW5nLCB0ZW5kZW5jeSwgYmVudDsgYSBwcmVwb25kZXJhdGluZyBkaXNwb3NpdGlvbiBvciBwcm9wZW5zaXR5OyBwcmVkaXNwb3NpdGlvbiB0b3dhcmRzOyBwcmVkaWxlY3Rpb247IHByZWp1ZGljZS4iIAoKQWxsIHRvbyBvZnRlbiBJIGhlYXIgcGVvcGxlIHRhbGsgYWJvdXQgdGhlIHNpZ25pZmljYW5jZSBvZiAiZWxpbWluYXRpbmcgYmlhcyIgZnJvbSBkYXRhIG9yICJhdm9pZGluZyBiaWFzZXMiIGluIGRhdGEgYW5hbHlzaXMuIFRoaXMgaXMgZmlyc3RseSBpbXBvc3NpYmxlLiBOdW1iZXJzIGRvIG5vdCBlbWVyZ2Ugb3V0IG9mIG5vd2hlcmUgYnV0IGVtZXJnZSBmcm9tIGh1bWFuIHBlcnNwZWN0aXZlcyAod2l0aCBpbmNsaW5hdGlvbnMsIGxlYW5pbmdzLCB0ZW5kZW5jaWVzLCBhbmQgYmVudHMpIGRlY2lkaW5nIHdoYXQgdG8gY291bnQgYW5kIGhvdyB0byBjb3VudCBpdC4gSSBjaGFsbGVuZ2UgYW55IG9uZSBvZiB5b3UgdG8gYXBwcm9hY2ggbWUgd2l0aCBhIG51bWJlciB0aGF0IGhhcyBub3QgaW4gc29tZSB3YXkgYmVlbiBnZW5lcmF0ZWQgYnkgYSBodW1hbiAoaGludDogdGhpcyBpcyBhIHRyaWNrIC0gaWYgeW91LCBhcyBhIGh1bWFuLCBjb21lIHRvIG1lIHdpdGggYSBudW1iZXIsIHlvdSd2ZSBhbHJlYWR5IGZhaWxlZCB0aGUgY2hhbGxlbmdlLikgWW91IGNhbiBuZXZlciByZW1vdmUgdGhhdCBodW1hbiBlbGVtZW50IGZyb20gZGF0YTsgdGhlcmUgd2lsbCBhbHdheXMgYmUgYmlhcy4gSWYgeW91IHRoaW5rIGFib3V0IGl0LCBldmVuIHRoZSBmZXJ2ZW50IGNvbW1pdG1lbnQgdG8gcmVtb3ZlIGJpYXMgZnJvbSBkYXRhIGlzIGEgYmlhcyEgCgpTZWNvbmRseSwgc3VnZ2VzdGluZyB0aGUgcG9zc2liaWxpdHkgdGhhdCBkYXRhIGNhbiBiZSBuZXV0cmFsIGNhbiBhY3R1YWxseSBleGFjZXJiYXRlIGNlcnRhaW4ga2luZHMgb2Ygc29jaWFsIGluanVzdGljZXMuIFdoZW4gd2Ugc3VnZ2VzdCB0aGF0IGl0IGlzIHBvc3NpYmxlIGZvciBudW1iZXJzIHRvIHNwZWFrIGZvciB0aGVtc2VsdmVzLCB3ZSB0ZW5kIHRvIGlnbm9yZSBhbGwgb2YgdGhlIHdheXMgdGhhdCBkYXRhIGNhbiBiZSB3ZWFwb25pemVkIGFnYWluc3QgZ3JvdXBzIG9mIHBlb3BsZS4gV2UgYXJlIHNlZWluZyB0aGlzIHBsYXkgb3V0IGNvbnN0YW50bHkgaW4gdGhlIG5ld3MgdG9kYXkuIFNvLWNhbGxlZCAidW5iaWFzZWQiIGFsZ29yaXRobXMgZm9yIHByZWRpY3Rpbmcgd2hlcmUgY3JpbWUgd2lsbCBoYXBwZW4gdHVybiBpbnRvIHRvb2xzIG9mIHN1cnZlaWxsYW5jZSBmb3IgcG9vciBhbmQgcmFjaWFsbHkgZGl2ZXJzZSBjb21tdW5pdGllczoKCjxpZnJhbWUgd2lkdGg9IjU2MCIgaGVpZ2h0PSIzMTUiIHNyYz0iaHR0cHM6Ly93d3cueW91dHViZS5jb20vZW1iZWQvWk1zU2NfdXRaNDAiIGZyYW1lYm9yZGVyPSIwIiBhbGxvd2Z1bGxzY3JlZW4+PC9pZnJhbWU+CgpTby1jYWxsZWQgInVuYmlhc2VkIiBhbGdvcml0aG1zIGZvciBzY3JlZW5pbmcgcmVzdW1lcyB0dXJuIG91dCB0byBmYXZvciBtZW4gb3ZlciB3b21lbiBhbmQgdHJhbnNnZW5kZXIgaW5kaXZpZHVhbHM6Cgo8aWZyYW1lIHdpZHRoPSI1NjAiIGhlaWdodD0iMzE1IiBzcmM9Imh0dHBzOi8vd3d3LnlvdXR1YmUuY29tL2VtYmVkL0pPelFqVC1oSjhrIiBmcmFtZWJvcmRlcj0iMCIgYWxsb3dmdWxsc2NyZWVuPjwvaWZyYW1lPgoKSW4gdGhpcyBzZW5zZSwgZmFsc2VseSBwcmVzZW50aW5nIGEgcG9zc2liaWxpdHkgb2YgZWxpbWluYXRpbmcgYmlhcyBnaXZlcyBudW1iZXJzIHRvbyBtdWNoIHJoZXRvcmljYWwgcG93ZXIsIG1ha2luZyBpdCBtdWNoIGhhcmRlciB0byBjcml0aXF1ZSB0aGUgaW5qdXN0aWNlcyB0aGV5IHByb3BhZ2F0ZS4KClRoaXMgaXMgbm90IHRvIHNheSB0aGF0IHdlIHNob3VsZG4ndCBjcml0aXF1ZSBkYXRhIHJlcHJlc2VudGF0aW9ucyBhbmQgY29tYmF0IGRhdGEgcHJhY3RpY2VzIHRoYXQgcHJvcGFnYXRlIGluZXF1YWxpdHkgb3IgaGFybSBjZXJ0YWluIGNvbW11bml0aWVzOyB3ZSBhYnNvbHV0ZWx5IHNob3VsZC4gSG93ZXZlciwgaW4gYSB3b3JsZCB3aGVyZSB0aGlzIGlzIHBsYXlpbmcgb3V0LCBJIHdvdWxkIG11Y2ggcHJlZmVyIHRvICprbm93KiB0aGUgcG9saXRpY3MgYW5kIHBlcnNwZWN0aXZlcyBvZiB0aGUgaW5kaXZpZHVhbHMgY29sbGVjdGluZyBkYXRhIGFuZCBwcm9kdWNpbmcgZGF0YSBhbmFseXNlcyB0aGFuIHRvIHByZXRlbmQgdGhleSBkb24ndCBleGlzdC4gVGhlbiBJIGNhbiBkZWNpZGUgZm9yIG15c2VsZiB3aGV0aGVyIEkgZmluZCB0aGVpciB3b3JrIHRydXN0d29ydGh5LiBXZSBuZWVkIGV0aGljYWwgYW5kIHBvbGl0aWNhbGx5IHJlc3BvbnNpYmxlIGh1bWFuIGRhdGEgc3Rld2FyZHMgLSBub3QgcHJvY2Vzc2VzIHRoYXQgcHJldGVuZCB0byBiZSBhYmxlIHRvIHN0cmlwIGRhdGEgb2YgaXRzIGh1bWFubmVzcy4gSSBob3BlIHlvdSBzZWUgdGhlc2Ugbm90ZWJvb2tzIGFzIGFuIG9wcG9ydHVuaXR5IHRvIGRldmVsb3Agc29tZSBvZiB0aGVzZSBza2lsbHMuIFRocm91Z2hvdXQgb3VyIHdvcmssIHdlIHdpbGwgdGFrZSBiaWFzZWQgZGF0YSBhcyBhIGdpdmVuIGFuZCBmaWd1cmUgb3V0IGhvdyB0byBtb3ZlIGZyb20gdGhlcmUuIAoKV2l0aCB0aGlzIGluIG1pbmQsIEkgaGF2ZSBhIHJlY29tbWVuZGF0aW9uIGZvciBob3cgeW91IHRoaW5rIGFib3V0IHRoZSB0ZXJtICdiaWFzJyBpbiB0aGVzZSBub3RlYm9va3MuIEFueSB0aW1lIHlvdSBmZWVsIGNvbXBlbGxlZCB0byB1c2UgYW55IHZlcnNpb24gb2YgdGhlIHdvcmQgJ2JpYXMnLCBJIGVuY291cmFnZSB5b3UgdG8gaGlnaGxpZ2h0IGl0IGFuZCB0aGVuIG91dGxpbmUgdGhyZWUgdGhpbmdzOiAKCjEuIFdoYXQga2luZCBvZiBiaWFzIGFyZSB5b3UgcmVmZXJyaW5nIHRvPyAKMi4gV2hvIHByb3BhZ2F0ZXMgdGhhdCBiaWFzPwozLiBXaGF0IGFyZSB0aGUgY29uc2VxdWVuY2VzIG9mIHRoYXQgYmlhcz8KCllvdSBtYXkgZmluZCB0aGF0IGl0IHdpbGwgdGFrZSBzb21lIHByYWN0aWNlIHRvIGRvIHRoaXMuIFRoZSB3b3JkIGJpYXMgaGFzIGJlY29tZSBzbyBpbmdyYWluZWQgaW4gcG9wdWxhciBsZXhpY29uIHRoYXQgd2UgY2FuIHNvbWV0aW1lcyBmb3JnZXQgd2h5IHdlIHNob3VsZCBwYXkgYXR0ZW50aW9uIHRvIG9yIGNhcmUgYWJvdXQgaXQgaW4gdGhlIGZpcnN0IHBsYWNlLiBUaGVzZSBub3RlYm9va3MgYXJlIGRlc2lnbmVkIHRvIGdldCB5b3UgdG8gdGhpbmsgbW9yZSBjcml0aWNhbGx5IGFib3V0IHdoZW4sIHdoeSwgYW5kIGhvdyBiaWFzZXMgaW4gZGF0YSBtYXR0ZXIgYW5kIHRvIHB1c2ggYmV5b25kIHNlZWluZyB0aGVtIGFzIGEgcHJvYmxlbSB3aXRoIGRhdGEgaW4gYW5kIG9mIHRoZW1zZWx2ZXMuCgojIyBJbnRyb2R1Y3Rpb24gdG8gUgoKQXQgdGhpcyBwb2ludCwgd2Ugd2lsbCBiZWdpbiB0byByZXZpZXcgc29tZSBiYXNpYyBmdW5jdGlvbmFsaXR5IGluIFIuIElmIHlvdSBoYXZlIGNvZGVkIGluIFIgYmVmb3JlLCB0aGlzIHdpbGwgbGFyZ2VseSBiZSBhIHJlZnJlc2hlci4gSWYgeW91IGhhdmUgbmV2ZXIgY29kZWQgaW4gUiBiZWZvcmUsIGRvbid0IHdvcnJ5LiBUaGlzIHNlY3Rpb24gaXMgcHJpbWFyaWx5IGRlc2lnbmVkIHRvIGdldCB5b3UgYWNjbGltYXRlZCB0byB0aGUgbGFuZ3VhZ2UgYW5kIHN5bWJvbHMgeW91IHdpbGwgc2VlIGluIGZ1dHVyZSBub3RlYm9va3MuIExhdGVyIG5vdGVib29rcyB3aWxsIHJldmlldyBzb21lIG9mIHRoaXMgbWF0ZXJpYWwgYXMgeW91IGNvbXBvc2UgeW91ciBvd24gY29kZSBpbiBSLiBBcyB5b3UgcmVhZCB0aHJvdWdoIGVhY2ggc2VjdGlvbiwgYmUgc3VyZSB0byBydW4gdGhlIGNvZGUgY2h1bmtzIHRvIHNlZSBob3cgdGhlIGNvZGUgaXMgb3BlcmF0aW5nLiAKCiMjIyBBc3NpZ25pbmcgVmFyaWFibGVzCgpWYXJpYWJsZXMgYXJlIHVzZWQgdG8gc3RvcmUgZGF0YSBpbiBSLiBXZSB1c2UgIjwtIiB0byBhc3NpZ24gYSB2YXJpYWJsZS4gVGhlIHRleHQgdGhhdCBjb21lcyBiZWZvcmUgIjwtIiB3aWxsIGJlIG91ciB2YXJpYWJsZSBuYW1lLCBhbmQgdGhlIHRleHQgdGhhdCBjb21lcyBhZnRlciAiPC0iIHdpbGwgYmUgdGhlIHZhbHVlIHN0b3JlZCBpbiBpdC4gCgpgYGB7cn0KI1J1biB0aGlzIGNvZGUgY2h1bmsuIAoKY2xhc3NfbmFtZSA8LSAiRGF0YSBTZW5zZSBhbmQgRXhwbG9yYXRpb24iCmNsYXNzX2RlcHQgPC0gIlNUUyIKY2xhc3NfbnVtYmVyIDwtICIxMTUiCmNsYXNzX3NpemUgPC0gMzMKCnN0c19tYWpvcnMgPC0gMjAKc3RhdHNfbWFqb3JzIDwtIDgKb3RoZXIgPC0gNQpgYGAKCkV2ZXJ5IG9iamVjdCBpbiBSIGhhcyBhIHBhcnRpY3VsYXIgKmNsYXNzKiwgd2hpY2ggZGVzaWduYXRlcyB0aGUgdmFyaWFibGUncyAidHlwZSIgYW5kIGhvdyBmdW5jdGlvbnMgY2FuIGJlIGFwcGxpZWQgdG8gaXQuIFdlIGNhbiBjaGVjayB0aGUgY2xhc3Mgb2YgYSB2YXJpYWJsZSBieSBjYWxsaW5nIGl0IGluICJjbGFzcygpIi4KCmBgYHtyfQpjbGFzcyhjbGFzc19uYW1lKQpjbGFzcyhjbGFzc19zaXplKQpjbGFzcyhjbGFzc19udW1iZXIpCmBgYAoKRGlkIHlvdSBub3RpY2UgaG93IGNsYXNzX251bWJlciBhYm92ZSBpcyBhIGNoYXJhY3RlciB2YXJpYWJsZT8gVGhpcyBpcyBiZWNhdXNlIHdoZW4gd2UgY3JlYXRlZCB0aGUgY2xhc3NfbnVtYmVyIHZhcmlhYmxlIGFib3ZlLCB3ZSBwdXQgdGhlIG51bWJlciBpbiBxdW90YXRpb24gbWFya3MgLSBpbmRpY2F0aW5nIHRvIFIgdG8gdHJlYXQgdGhlIG51bWJlciBhcyBhIHNldCBvZiBjaGFyYWN0ZXJzIHJhdGhlciB0aGFuIGEgbnVtYmVyLiBTaW5jZSBvdXIgY2xhc3MgbnVtYmVyIGlzIGEgcmVmZXJlbmNlIHRvIG91ciBjbGFzcywgaXQgYWN0cyBtb3JlIGxpa2UgYSBsYWJlbCB0aGFuIGEgbnVtYmVyLiAKCklmIHNvbWVvbmUgZHJvcHMgYSBjbGFzcywgd2UgY2FuIGVhc2lseSBjaGFuZ2UgdGhlIHZhbHVlIG9mIHRoZSBjbGFzcyBzaXplIHZhcmlhYmxlLgoKYGBge3J9CiNTdG9yZSB0aGUgY2FsY3VsYXRpb24gaW4gYSB2YXJpYWJsZS4KY2xhc3Nfc2l6ZSA8LSBjbGFzc19zaXplIC0gMQoKI1ByaW50IHRoZSB2YXJpYWJsZQpjbGFzc19zaXplCmBgYAoKTm90aWNlIGhvdyB3ZSByZS1hc3NpZ25lZCB0aGUgbmV3IHN1YnRyYWN0ZWQgdmFsdWUgdG8gY2xhc3Nfc2l6ZSBhYm92ZS4gCgpXZSBjYW4gYWxzbyBwZXJmb3JtIGNhbGN1bGF0aW9ucyBvbiB2YXJpYWJsZXMsIHN1Y2ggYXMgYWRkaXRpb24sIHN1YnRyYWN0aW9uLCBtdWx0aXBsaWNhdGlvbiwgYW5kIGRpdmlzaW9uLiBDaGVja2luZyB3aGV0aGVyIHZhcmlhYmxlcyBhcmUgZ3JlYXRlciB0aGFuLCBsZXNzIHRoYW4sIG9yIGVxdWFsIHRvIGVhY2ggb3RoZXIgd2lsbCByZXR1cm4gVFJVRSBvciBGQUxTRS4gCgpgYGB7cn0Kc3RzX21ham9ycyArIHN0YXRzX21ham9ycwoKc3RzX21ham9ycyA+IHN0YXRzX21ham9ycwpgYGAKCldlIGNhbiBhbHNvIHBlcmZvcm0gb3BlcmF0aW9ucyBvbiBzdHJpbmdzIC0gY29uY2F0ZW5hdGluZyB0aGVtIHdpdGggdGhlICpwYXN0ZSogZnVuY3Rpb24uIEZvciBpbnN0YW5jZSwgd2UgY2FuIHBhc3RlIHRoZSBjbGFzc19kZXB0IHN0cmluZyB3aXRoIHRoZSBjbGFzc19udW1iZXIgc3RyaW5nIHRvIGNyZWF0ZSBhIGNsYXNzIGNvZGUuIFdoZW4gd2UgZG8gdGhpcywgd2UgbmVlZCB0byB0ZWxsIFIgd2hhdCBjaGFyYWN0ZXJzIHNob3VsZCBzZXBhcmF0ZSB0aGUgc3RyaW5ncy4gV2Ugd2lsbCByZXZpZXcgdGhpcyBhZ2FpbiBsYXRlciBpbiB0aGUgcXVhcnRlci4gCgpgYGB7cn0KY2xhc3NfY29kZSA8LSBwYXN0ZShjbGFzc19kZXB0LCBjbGFzc19udW1iZXIsIHNlcD0iICIpCmNsYXNzX2NvZGUKYGBgCgojIyMgVmVjdG9ycwoKQSB2ZWN0b3IgaXMgYSBzZXQgb2YgdmFsdWVzIChvcmdhbml6ZWQgbGlrZSBhIGxpc3QpIHRoYXQgYXJlIGFsbCBvZiB0aGUgc2FtZSB0eXBlLiBBIHZlY3RvciBjYW4gYmUgb2YgdHlwZSBpbnRlZ2VyLCBkb3VibGUsIGNoYXJhY3RlcnMsIGxvZ2ljYWwsIGZvciBleGFtcGxlLiBXZSBjcmVhdGUgYSB2ZWN0b3IgYnkgcGxhY2luZyBhIHNldCBvZiB2YWx1ZXMgaW4gImMoX19fKSIuIEhlcmUgYyBzdGFuZHMgZm9yICJjb21iaW5lIiAtIGluZGljYXRpbmcgdGhhdCB3ZSBhcmUgY29tYmluaW5nIHZhbHVlcy4gCgpgYGB7cn0KYmlydGhfbW9udGhzIDwtIGMoNCwgNywgMTIsIDMsIDEpCmZpcnN0X2xldHRlcl9uYW1lIDwtIGMoIkEiLCJCIiwiQyIsIkQiLCJFIikKdGltZV9vbl9waG9uZSA8LSBjKDM0LCA5MCwgMiwgNiwgTkEpCmBgYAoKV2UgY2FuIG1lYXN1cmUgdGhlIGxlbmd0aCBvZiBhIHZlY3RvciBieSBjYWxsaW5nIHRoZSBmdW5jdGlvbiAqbGVuZ3RoKi4gVGhpcyBjb3VudHMgaG93IG1hbnkgdmFsdWVzIGFyZSBsaXN0ZWQgaW4gdGhlIHZlY3Rvci4gCgpgYGB7cn0KbGVuZ3RoKGJpcnRoX21vbnRocykKYGBgCgpXZSBjYW4gYWxzbyBleHRyYWN0IHZhbHVlcyBmcm9tIHNwZWNpZmljIHBvc2l0aW9ucyBpbiB0aGUgdmVjdG9yIGJ5IHJlZmVyZW5jaW5nIHRoZSBpbmRleCBpbiBicmFja2V0cy4gU28gbGV0J3Mgc2F5IEkgd2FudCB0byBleHRyYWN0IHRoZSB0aGlyZCB2YWx1ZSBpbiB0aGUgdmVjdG9yLiAKCmBgYHtyfQpiaXJ0aF9tb250aHNbM10KYGBgCgpUbyBleHRyYWN0IGFsbCB2YWx1ZXMgZXhjZXB0IHRoZSB2YWx1ZSBpbiBhIHBhcnRpY3VsYXIgcG9zaXRpb24sIHdlIHdpbGwgdXNlIHRoZSAiLSIgc2lnbiBiZWZvcmUgdGhlIGluZGV4IGluIGJyYWNrZXRzLiBTbyBsZXQncyBzYXkgSSB3YW50IHRvIGV4dHJhY3QgYWxsIHZhbHVlcyBleGNlcHQgdGhlIHRoaXJkIGluIHRoZSB2ZWN0b3IuCgpgYGB7cn0KYmlydGhfbW9udGhzWy0zXQpgYGAKCldlIGNhbiBhbHNvIGV4dHJhY3QgYSByYW5nZSBvZiB2YWx1ZXMgZnJvbSBzcGVjaWZpYyBwb3NpdGlvbnMgaW4gdGhlIHZlY3RvciBieSByZWZlcmVuY2luZyB0aGF0IHJhbmdlIG9mIGluZGV4ZXMgaW4gYnJhY2tldHMgc2VwYXJhdGVkIGJ5IGEgIjoiLiBTbyBsZXQncyBzYXkgSSB3YW50IHRvIGV4dHJhY3QgdGhlIGZpcnN0IHRocm91Z2ggdGhlIHRoaXJkIHZhbHVlIGluIHRoZSB2ZWN0b3IuCgpgYGB7cn0KZmlyc3RfbGV0dGVyX25hbWVbMTozXQpgYGAKCkZpbmFsbHksIHRvIGV4dHJhY3QgdmFsdWVzIGZyb20gYSBub24tc2VxdWVudGlhbCBjb21iaW5hdGlvbiBvZiBzcGVjaWZpYyBwb3NpdGlvbnMgaW4gdGhlIHZlY3Rvciwgd2UgY2FuIHJlZmVyZW5jZSBlYWNoIG9mIHRoZWlyIGluZGV4ZXMgaW4gYnJhY2tldHMgaW4gImMoKSIuICAKCmBgYHtyfQpmaXJzdF9sZXR0ZXJfbmFtZVtjKDEsMyw1KV0KYGBgCgpXZSBjYW4gcGVyZm9ybSBvcGVyYXRpb25zIG9uIHZlY3RvcnMgLSBmaW5kaW5nIHRoZWlyIG1heCwgdGhlaXIgbWluLCB0aGVpciBzdW0sIHRoZWlyIGF2ZXJhZ2UsIGZvciBleGFtcGxlLiBIb3dldmVyLCB3ZSBtYXkgZ2V0IGFuIGVycm9yIGlmIHdlIGhhdmUgYW55IGVtcHR5IHZhbHVlcyBpbiB0aGUgZGF0YXNldC4gVG8gYXZvaWQgdGhpcywgd2UgbmVlZCB0byBjb21tdW5pY2F0ZSB0byBSIHRvIHJlbW92ZSBOQSB2YWx1ZXMuIAoKYGBge3J9Cm1heCh0aW1lX29uX3Bob25lKQptaW4odGltZV9vbl9waG9uZSkKc3VtKHRpbWVfb25fcGhvbmUpCm1lYW4odGltZV9vbl9waG9uZSkKCm1heCh0aW1lX29uX3Bob25lLCBuYS5ybT1UUlVFKQptaW4odGltZV9vbl9waG9uZSwgbmEucm09VFJVRSkKc3VtKHRpbWVfb25fcGhvbmUsIG5hLnJtPVRSVUUpCm1lYW4odGltZV9vbl9waG9uZSwgbmEucm09VFJVRSkKYGBgCgojIyMgTWF0cmljZXMKCldlIHdvbid0IGJlIHVzaW5nIG1hdHJpY2VzIGluIHRoZXNlIG5vdGVib29rcy4gSG93ZXZlciwga25vd2luZyB0aGlzIGRhdGEgdHlwZSB3aWxsIGhlbHAgeW91IHVuZGVyc3RhbmQgaXRzIGRpZmZlcmVuY2VzIGZyb20gdGhlIGRhdGEgdHlwZXMgd2Ugd2lsbCB1c2UuIExldCdzIGNyZWF0ZSBhIHNlY29uZCBudW1lcmljIHZlY3Rvci4gCgpgYGB7cn0KYmlydGhfbW9udGhzMiA8LSBjKDExLCAxMiwgMywgNCwgNCkKYGBgCgpCeSBiaW5kaW5nIHRoaXMgdG9nZXRoZXIgd2l0aCBiaXJ0aF9tb250aHMsIHdlIGNyZWF0ZSBhIG1hdHJpeCAtIG9yIGEgMi1kaW1lbnNpb25hbCBjb2xsZWN0aW9uIG9mIGVsZW1lbnRzIG9mIGFsbCB0aGUgc2FtZSB0eXBlLgoKYGBge3J9CmJpcnRoX21vbnRoc19tYXRyaXggPC0gcmJpbmQoYmlydGhfbW9udGhzLCBiaXJ0aF9tb250aHMyKQpiaXJ0aF9tb250aHNfbWF0cml4CmBgYAoKV2UgY2FuIGRldGVybWluZSB0aGUgbnVtYmVyIG9mIHJvd3MgaW4gdGhlIG1hdHJpeCBieSBjYWxsaW5nICpucm93KiBhbmQgd2UgY2FuIGRldGVybWluZSB0aGUgbnVtYmVyIG9mIGNvbHVtbnMgaW4gdGhlIG1hdHJpeCBieSBjYWxsaW5nICpuY29sKi4KCmBgYHtyfQpucm93KGJpcnRoX21vbnRoc19tYXRyaXgpCm5jb2woYmlydGhfbW9udGhzX21hdHJpeCkKYGBgCgpXZSBjYW4gYWxzbyBleHRyYWN0IHZhbHVlcyBmcm9tIHNwZWNpZmljIHBvc2l0aW9ucyBpbiB0aGUgdmVjdG9yIGJ5IHJlZmVyZW5jaW5nIHRoZSByb3cgcG9zaXRpb24gYW5kIHRoZSBjb2x1bW4gcG9zaXRpb24gb2YgdGhlIG51bWJlciBpbiBicmFja2V0cy4gVGhlIGZvcm1hdCBmb3IgZG9pbmcgc28gaXMgW3JvdywgY29sdW1uXSBTbyBsZXQncyBzYXkgdGhhdCB3ZSB3YW50IHRvIGV4dHJhY3QgdGhlIHZhbHVlIGluIHRoZSBzZWNvbmQgcm93LCB0aGlyZCBjb2x1bW4uCgpgYGB7cn0KYmlydGhfbW9udGhzX21hdHJpeFsyLDNdCmBgYAoKVG8gZXh0cmFjdCB0aGUgZW50aXJlIHNlY29uZCByb3csIHdlIHdvdWxkIGxlYXZlIHRoZSBjb2x1bW4gcG9zaXRpb24gYmxhbmsuIFRoaXMgd291bGQgcmV0dXJuIGEgKnZlY3Rvciogb2YgdmFsdWVzIHN0b3JlZCBpbiB0aGUgc2Vjb25kIHJvdyBvZiB0aGUgbWF0cml4LgoKYGBge3J9CmJpcnRoX21vbnRoc19tYXRyaXhbMixdCmBgYAoKQW5kIHRvIGV4dHJhY3QgdGhlIGVudGlyZSB0aGlyZCBjb2x1bW4sIHdlIHdvdWxkIGxlYXZlIHRoZSByb3cgcG9zaXRpb24gYmxhbmsuIFRoaXMgd291bGQgcmV0dXJuIGEgKnZlY3Rvciogb2YgdmFsdWVzIHN0b3JlZCBpbiB0aGUgdGhpcmQgY29sdW1uIG9mIHRoZSBtYXRyaXguIAoKYGBge3J9CmJpcnRoX21vbnRoc19tYXRyaXhbLDNdCmBgYAoKIyMjIExpc3RzCgpJIHdpbGwgb25seSBicmllZmx5IGdvIG92ZXIgKmxpc3RzKiBiZWNhdXNlLCBmb3IgdGhlIG1vc3QgcGFydCwgd2Ugd2lsbCBub3QgYmUgdXNpbmcgdGhlbSBpbiB0aGVzZSBub3RlYm9va3MuICpMaXN0cyogYXJlIGNvbGxlY3Rpb25zIG9mIG9iamVjdHMgaW4gUi4gRm9yIGluc3RhbmNlLCB5b3UgY2FuIGhhdmUgYSBjb2xsZWN0aW9uIG9mIG51bWVyaWMgdmVjdG9ycywgY2hhcmFjdGVyIHZlY3RvcnMsIGxvZ2ljYWwgdmVjdG9ycywgbWF0cmljZXMsIGFuZCBvdGhlciBsaXN0cy4gWW91IGNhbiBhc3NpZ24gbmFtZXMgdG8gdGhlIG9iamVjdHMgaW4gbGlzdHMgc28gdGhhdCB5b3UgY2FuIG1vcmUgZWFzaWx5IHJlZmVyZW5jZSB0aGVtLiBGb3IgaW5zdGFuY2UsIGJlbG93IEkgYXNzaWduIHRoZSBuYW1lIHgsIHksIGFuZCB6IHRvIHRoZSB0aHJlZSBvYmplY3RzIHJlc3BlY3RpdmVseS4gT25jZSBhIG5hbWUgaGFzIGJlZW4gYXNzaWduZWQgdG8gdGhlIG9iamVjdCwgeW91IGNhbiByZWZlcmVuY2UgaXQgYnkgbGlzdGluZyB0aGUgbmFtZSBvZiB0aGUgbGlzdCBmb2xsb3dlZCBieSB0aGUgKiQqIGZvbGxvd2VkIGJ5IHRoZSBuYW1lIG9mIHRoZSBvYmplY3QuIAoKYGBge3J9CmZpcnN0X2xpc3QgPC0gbGlzdCh4ID0gZmlyc3RfbGV0dGVyX25hbWUsIHkgPSB0aW1lX29uX3Bob25lLCB6ID0gYmlydGhfbW9udGhzKQoKZmlyc3RfbGlzdCR4WzI6M10KZmlyc3RfbGlzdCR5W2MoMSw0KV0KZmlyc3RfbGlzdCR6WzJdCmBgYAoKIyMjIERhdGEgRnJhbWVzCgpJbiB0aGVzZSBub3RlYm9va3MsIHdlIHdpbGwgYmUgd29ya2luZyBwcmltYXJpbHkgd2l0aCByZWN0YW5ndWxhciBkYXRhc2V0cyBpbiBhIGRhdGEgdHlwZSBjYWxsZWQgYSAqZGF0YSBmcmFtZSouICBBIGRhdGEgZnJhbWUgaGFzIGEgY2VydGFpbiBudW1iZXIgb2Ygcm93cyBhbmQgYSBjZXJ0YWluIG51bWJlciBvZiBjb2x1bW5zLiBJdCBpcyBhIGxpc3Qgb2YgKnZlY3RvcnMqIG9mIGFsbCB0aGUgc2FtZSBsZW5ndGguIAoKKipGcm9tIHRoaXMgcG9pbnQgZm9yd2FyZCwgd2Ugd2lsbCByZWZlciB0byBlYWNoIHJvdyBpbiBhIGRhdGEgZnJhbWUgYXMgYW4gKm9ic2VydmF0aW9uKiBhbmQgZWFjaCBjb2x1bW4gaW4gYSBkYXRhIGZyYW1lIGFzIGEgKnZhcmlhYmxlKi4qKiBUaGlzIGlzIGJlY2F1c2Ugcm93cyByZWZlciB0byBzb21ldGhpbmcgdGhhdCB3ZSBzZWUgaW4gdGhlIHdvcmxkLCBhbmQgY29sdW1ucyBkZXNjcmliZSB0aGF0IHRoaW5nIHdlIGFyZSBzZWVpbmcuIEltYWdpbmUgd2UgaGF2ZSBhIHRhYmxlIGxpa2UgdGhpcyBiZWxvdy4KCk5hbWUgfCBBZ2UgfCBCaXJ0aCBNb250aCB8IFRpbWUgb24gUGhvbmUKLS0tLSB8IC0tLS0gfCAtLS0tIHwgLS0tLSB8ClNhbGx5IHwgMjMgfCAzIHwgNDIKSnVsaWUgfCA0MCB8IDIgfCA5OApNYXJrIHwgMTQgfCA4IHwgMTIwCgpFYWNoIHJvdyBpcyBhbiBvYnNlcnZhdGlvbiAtIGluIHRoaXMgY2FzZSBhIHBlcnNvbiAtIGFuZCBlYWNoIGNvbHVtbiBpcyBhIHZhcmlhYmxlIGRlc2NyaWJpbmcgc29tZXRoaW5nIGFib3V0IGEgcGVyc29uLiBOb3RlIGhvdyBlYWNoIGNvbHVtbiBpcyBhbHNvIGEgdmVjdG9yLiBUaGUgTmFtZSBjb2x1bW4gaXMgYSBjaGFyYWN0ZXIgdmVjdG9yIG9mIG5hbWVzLiBUaGUgQWdlIGNvbHVtbiBpcyBhIG51bWVyaWMgdmVjdG9yIG9mIGFnZXMuCgpMZXQncyBnbyBoZWFkIGFuZCBjcmVhdGUgdGhpcyB2ZWN0b3IgYmVsb3c6CgpgYGB7cn0KZGYgPC0gZGF0YS5mcmFtZShuYW1lID0gYygiU2FsbHkiLCAiSnVsaWUiLCAiTWlrZSIpLCAKICAgICAgICAgICAgICAgICBhZ2UgPSBjKDIzLCA0MCwgMTQpLCAKICAgICAgICAgICAgICAgICBiaXJ0aF9tb250aCA9IGMoMywgMiwgOCksCiAgICAgICAgICAgICAgICAgdGltZV9vbl9waG9uZSA9IGMoNDIsIDk4LCAxMjApKQpgYGAKCldoZW4gd29ya2luZyB3aXRoIHZlcnkgbGFyZ2UgZGF0YXNldHMsIHdlIG5lZWQgdG9vbHMgdG8gaGVscCB1cyBnZXQgYSBzZW5zZSBvZiB0aGUgZGF0YXNldCB3aXRob3V0IGhhdmluZyB0byBsb2FkIHRoZSBlbnRpcmUgZGF0YSBmcmFtZS4gRm9yIGluc3RhbmNlLCB3ZSBjYW4gdmlldyB0aGUgZmlyc3QgNiByb3dzIG9mIHRoZSBkYXRhc2V0IGJ5IGNhbGxpbmcgKmhlYWQoKSouCgpgYGB7cn0KaGVhZChkZikKYGBgCgoqZGltKCkqIHdpbGwgdGVsbCB1cyB0aGUgZGltZW5zaW9ucyBvZiB0aGUgZGF0YSBmcmFtZSAtIGkuZS4gdGhlIG51bWJlciBvZiByb3dzIGFuZCB0aGUgbnVtYmVyIG9mIGNvbHVtbnMgaW4gdGhlIGRhdGEgZnJhbWUuIAoKYGBge3J9CmRpbShkZikKYGBgCgoic3RyKCkiIHByb3ZpZGVzIGEgZ3JlYXQgZGVhbCBvZiBpbmZvcm1hdGlvbiBhYm91dCB0aGUgb2JzZXJ2YXRpb25zIGluIHRoZSBkYXRhIGZyYW1lLCBpbmNsdWRpbmcgdGhlIG51bWJlciBvZiB2YXJpYWJsZXMsIHRoZSBudW1iZXIgb2Ygb2JzZXJ2YXRpb25zLCB0aGUgdmFyaWFibGUgbmFtZXMsIHRoZWlyIGRhdGEgdHlwZXMsIGFuZCBhIGxpc3Qgb2Ygb2JzZXJ2YXRpb25zLgoKYGBge3J9CnN0cihkZikKYGBgCgpKdXN0IGxpa2UgYXMgd2UgaGFkIGRvbmUgd2l0aCBtYXRyaWNlcywgd2UgY2FuIGV4dHJhY3QgcGFydGljdWxhciByb3dzIGFuZCBjb2x1bW5zIGluIGEgZGF0YSBmcmFtZSBieSByZWZlcnJpbmcgdG8gdGhlaXIgaW5kZXhlcyBpbiBicmFja2V0cy4gCgpgYGB7cn0KZGZbMiw0XQpgYGAKCldlIG9mdGVuIGRvbid0IHdhbnQgdG8gaGF2ZSB0aGUgY291bnQgdGhlIGluZGV4IG9mIGVhY2ggY29sdW1uIGluIG9yZGVyIHRvIHJlZmVyIHRvIGEgcGFydGljdWxhciB2YXJpYWJsZSBpbiBvdXIgZGF0YWZyYW1lLiBJbnN0ZWFkLCB3ZSBjYW4gcmVmZXIgdG8gdGhlIHZhcmlhYmxlIChjb2x1bW4pIG5hbWUgdXNpbmcgdGhlIHNhbWUgIiQiIG5vdGF0aW9uIHRoYXQgd2UgZGlzY3Vzc2VkIGFib3ZlLiBGb3IgaW5zdGFuY2UsIEkgY291bGQgc2VlIHRoZSB2YWx1ZXMgaW4gdGhlIGJpcnRoX21vbnRoIGNvbHVtbiBieSBjYWxsaW5nOgoKYGBge3J9CmRmJGJpcnRoX21vbnRoCmBgYAoKSWYgSSB3YW50ZWQgdGhlIGV4dHJhY3QgdGhlIHNlY29uZCBvYnNlcnZhdGlvbiBpbiB0aGUgYmlydGhfbW9udGgsIEkgd291bGQgY2FsbDoKCmBgYHtyfQpkZiRiaXJ0aF9tb250aFsyXQpgYGAKCldoYXQgaWYgeW91IGRvbid0IGtub3cgd2hhdCB0aGUgY29sdW1uIG5hbWVzIGFyZT8gVG8gc2VlIGEgbGlzdCBvZiBjb2x1bW4gbmFtZXMsIHdlIGNvdWxkIHJlZmVyIHRvIHRoZSBkYXRhIGRpY3Rpb25hcnkuIFdlIGNvdWxkIGFsc28gdXNlIHRoZSBmdW5jdGlvbiAiY29sbmFtZXMoKSIuIAoKYGBge3J9CmNvbG5hbWVzKGRmKQpgYGAKRmluYWxseSwgb24gdGhlIHRvcCByaWdodCBoYW5kIHNpZGUgb2YgeW91ciBSU3R1ZGlvIHNjcmVlbiwgeW91IHdpbGwgc2VlIGEgdGFiIGNhbGxlZCBFbnZpcm9ubWVudC4gSWYgeW91IGNsaWNrIG9uIHRoYXQgdGFiLCB5b3Ugc2hvdWxkIHNlZSBhbGwgb2YgdGhlIGRhdGEgdGhhdCB5b3UgaGF2ZSBzdG9yZWQgaW4gdmFyaWFibGVzLiBZb3UgY2FuIGNoZWNrIGNvbHVtbiBuYW1lcyBoZXJlLiAKCgo=