├── .gitignore
├── .travis.yml
├── LICENSE
├── README.md
├── benchmark.nix
├── build.nix
├── ci.nix
├── flake-compat.nix
├── flake.lock
├── flake.nix
├── plot.nix
├── run.nix
├── scripts
├── plot
└── run
└── src
├── Makefile
├── dt.hpp
├── entry.asm
├── io.cpp
├── io.hpp
├── main.cpp
├── msr.hpp
├── selectors.hpp
├── standalone.lds
├── start.asm
├── types.hpp
└── x86-instructions.hpp
/.gitignore:
--------------------------------------------------------------------------------
1 | /result
2 | /result-*
3 | *.o
4 | *.elf*
5 |
--------------------------------------------------------------------------------
/.travis.yml:
--------------------------------------------------------------------------------
1 | dist: bionic
2 | language: cpp
3 | compiler: gcc
4 | addons:
5 | apt:
6 | update: true
7 |
8 | before_install:
9 | - sudo add-apt-repository -y ppa:jonathonf/tup
10 | - sudo add-apt-repository -y ppa:jacob/virtualisation
11 | - sudo apt-get update -q
12 | - sudo apt-get install -y tup qemu-system-x86 nasm g++ python3-matplotlib
13 |
14 | script:
15 | - tup
16 | - cat measurements.csv
17 |
--------------------------------------------------------------------------------
/LICENSE:
--------------------------------------------------------------------------------
1 | GNU AFFERO GENERAL PUBLIC LICENSE
2 | Version 3, 19 November 2007
3 |
4 | Copyright (C) 2007 Free Software Foundation, Inc.
5 | Everyone is permitted to copy and distribute verbatim copies
6 | of this license document, but changing it is not allowed.
7 |
8 | Preamble
9 |
10 | The GNU Affero General Public License is a free, copyleft license for
11 | software and other kinds of works, specifically designed to ensure
12 | cooperation with the community in the case of network server software.
13 |
14 | The licenses for most software and other practical works are designed
15 | to take away your freedom to share and change the works. By contrast,
16 | our General Public Licenses are intended to guarantee your freedom to
17 | share and change all versions of a program--to make sure it remains free
18 | software for all its users.
19 |
20 | When we speak of free software, we are referring to freedom, not
21 | price. Our General Public Licenses are designed to make sure that you
22 | have the freedom to distribute copies of free software (and charge for
23 | them if you wish), that you receive source code or can get it if you
24 | want it, that you can change the software or use pieces of it in new
25 | free programs, and that you know you can do these things.
26 |
27 | Developers that use our General Public Licenses protect your rights
28 | with two steps: (1) assert copyright on the software, and (2) offer
29 | you this License which gives you legal permission to copy, distribute
30 | and/or modify the software.
31 |
32 | A secondary benefit of defending all users' freedom is that
33 | improvements made in alternate versions of the program, if they
34 | receive widespread use, become available for other developers to
35 | incorporate. Many developers of free software are heartened and
36 | encouraged by the resulting cooperation. However, in the case of
37 | software used on network servers, this result may fail to come about.
38 | The GNU General Public License permits making a modified version and
39 | letting the public access it on a server without ever releasing its
40 | source code to the public.
41 |
42 | The GNU Affero General Public License is designed specifically to
43 | ensure that, in such cases, the modified source code becomes available
44 | to the community. It requires the operator of a network server to
45 | provide the source code of the modified version running there to the
46 | users of that server. Therefore, public use of a modified version, on
47 | a publicly accessible server, gives the public access to the source
48 | code of the modified version.
49 |
50 | An older license, called the Affero General Public License and
51 | published by Affero, was designed to accomplish similar goals. This is
52 | a different license, not a version of the Affero GPL, but Affero has
53 | released a new version of the Affero GPL which permits relicensing under
54 | this license.
55 |
56 | The precise terms and conditions for copying, distribution and
57 | modification follow.
58 |
59 | TERMS AND CONDITIONS
60 |
61 | 0. Definitions.
62 |
63 | "This License" refers to version 3 of the GNU Affero General Public License.
64 |
65 | "Copyright" also means copyright-like laws that apply to other kinds of
66 | works, such as semiconductor masks.
67 |
68 | "The Program" refers to any copyrightable work licensed under this
69 | License. Each licensee is addressed as "you". "Licensees" and
70 | "recipients" may be individuals or organizations.
71 |
72 | To "modify" a work means to copy from or adapt all or part of the work
73 | in a fashion requiring copyright permission, other than the making of an
74 | exact copy. The resulting work is called a "modified version" of the
75 | earlier work or a work "based on" the earlier work.
76 |
77 | A "covered work" means either the unmodified Program or a work based
78 | on the Program.
79 |
80 | To "propagate" a work means to do anything with it that, without
81 | permission, would make you directly or secondarily liable for
82 | infringement under applicable copyright law, except executing it on a
83 | computer or modifying a private copy. Propagation includes copying,
84 | distribution (with or without modification), making available to the
85 | public, and in some countries other activities as well.
86 |
87 | To "convey" a work means any kind of propagation that enables other
88 | parties to make or receive copies. Mere interaction with a user through
89 | a computer network, with no transfer of a copy, is not conveying.
90 |
91 | An interactive user interface displays "Appropriate Legal Notices"
92 | to the extent that it includes a convenient and prominently visible
93 | feature that (1) displays an appropriate copyright notice, and (2)
94 | tells the user that there is no warranty for the work (except to the
95 | extent that warranties are provided), that licensees may convey the
96 | work under this License, and how to view a copy of this License. If
97 | the interface presents a list of user commands or options, such as a
98 | menu, a prominent item in the list meets this criterion.
99 |
100 | 1. Source Code.
101 |
102 | The "source code" for a work means the preferred form of the work
103 | for making modifications to it. "Object code" means any non-source
104 | form of a work.
105 |
106 | A "Standard Interface" means an interface that either is an official
107 | standard defined by a recognized standards body, or, in the case of
108 | interfaces specified for a particular programming language, one that
109 | is widely used among developers working in that language.
110 |
111 | The "System Libraries" of an executable work include anything, other
112 | than the work as a whole, that (a) is included in the normal form of
113 | packaging a Major Component, but which is not part of that Major
114 | Component, and (b) serves only to enable use of the work with that
115 | Major Component, or to implement a Standard Interface for which an
116 | implementation is available to the public in source code form. A
117 | "Major Component", in this context, means a major essential component
118 | (kernel, window system, and so on) of the specific operating system
119 | (if any) on which the executable work runs, or a compiler used to
120 | produce the work, or an object code interpreter used to run it.
121 |
122 | The "Corresponding Source" for a work in object code form means all
123 | the source code needed to generate, install, and (for an executable
124 | work) run the object code and to modify the work, including scripts to
125 | control those activities. However, it does not include the work's
126 | System Libraries, or general-purpose tools or generally available free
127 | programs which are used unmodified in performing those activities but
128 | which are not part of the work. For example, Corresponding Source
129 | includes interface definition files associated with source files for
130 | the work, and the source code for shared libraries and dynamically
131 | linked subprograms that the work is specifically designed to require,
132 | such as by intimate data communication or control flow between those
133 | subprograms and other parts of the work.
134 |
135 | The Corresponding Source need not include anything that users
136 | can regenerate automatically from other parts of the Corresponding
137 | Source.
138 |
139 | The Corresponding Source for a work in source code form is that
140 | same work.
141 |
142 | 2. Basic Permissions.
143 |
144 | All rights granted under this License are granted for the term of
145 | copyright on the Program, and are irrevocable provided the stated
146 | conditions are met. This License explicitly affirms your unlimited
147 | permission to run the unmodified Program. The output from running a
148 | covered work is covered by this License only if the output, given its
149 | content, constitutes a covered work. This License acknowledges your
150 | rights of fair use or other equivalent, as provided by copyright law.
151 |
152 | You may make, run and propagate covered works that you do not
153 | convey, without conditions so long as your license otherwise remains
154 | in force. You may convey covered works to others for the sole purpose
155 | of having them make modifications exclusively for you, or provide you
156 | with facilities for running those works, provided that you comply with
157 | the terms of this License in conveying all material for which you do
158 | not control copyright. Those thus making or running the covered works
159 | for you must do so exclusively on your behalf, under your direction
160 | and control, on terms that prohibit them from making any copies of
161 | your copyrighted material outside their relationship with you.
162 |
163 | Conveying under any other circumstances is permitted solely under
164 | the conditions stated below. Sublicensing is not allowed; section 10
165 | makes it unnecessary.
166 |
167 | 3. Protecting Users' Legal Rights From Anti-Circumvention Law.
168 |
169 | No covered work shall be deemed part of an effective technological
170 | measure under any applicable law fulfilling obligations under article
171 | 11 of the WIPO copyright treaty adopted on 20 December 1996, or
172 | similar laws prohibiting or restricting circumvention of such
173 | measures.
174 |
175 | When you convey a covered work, you waive any legal power to forbid
176 | circumvention of technological measures to the extent such circumvention
177 | is effected by exercising rights under this License with respect to
178 | the covered work, and you disclaim any intention to limit operation or
179 | modification of the work as a means of enforcing, against the work's
180 | users, your or third parties' legal rights to forbid circumvention of
181 | technological measures.
182 |
183 | 4. Conveying Verbatim Copies.
184 |
185 | You may convey verbatim copies of the Program's source code as you
186 | receive it, in any medium, provided that you conspicuously and
187 | appropriately publish on each copy an appropriate copyright notice;
188 | keep intact all notices stating that this License and any
189 | non-permissive terms added in accord with section 7 apply to the code;
190 | keep intact all notices of the absence of any warranty; and give all
191 | recipients a copy of this License along with the Program.
192 |
193 | You may charge any price or no price for each copy that you convey,
194 | and you may offer support or warranty protection for a fee.
195 |
196 | 5. Conveying Modified Source Versions.
197 |
198 | You may convey a work based on the Program, or the modifications to
199 | produce it from the Program, in the form of source code under the
200 | terms of section 4, provided that you also meet all of these conditions:
201 |
202 | a) The work must carry prominent notices stating that you modified
203 | it, and giving a relevant date.
204 |
205 | b) The work must carry prominent notices stating that it is
206 | released under this License and any conditions added under section
207 | 7. This requirement modifies the requirement in section 4 to
208 | "keep intact all notices".
209 |
210 | c) You must license the entire work, as a whole, under this
211 | License to anyone who comes into possession of a copy. This
212 | License will therefore apply, along with any applicable section 7
213 | additional terms, to the whole of the work, and all its parts,
214 | regardless of how they are packaged. This License gives no
215 | permission to license the work in any other way, but it does not
216 | invalidate such permission if you have separately received it.
217 |
218 | d) If the work has interactive user interfaces, each must display
219 | Appropriate Legal Notices; however, if the Program has interactive
220 | interfaces that do not display Appropriate Legal Notices, your
221 | work need not make them do so.
222 |
223 | A compilation of a covered work with other separate and independent
224 | works, which are not by their nature extensions of the covered work,
225 | and which are not combined with it such as to form a larger program,
226 | in or on a volume of a storage or distribution medium, is called an
227 | "aggregate" if the compilation and its resulting copyright are not
228 | used to limit the access or legal rights of the compilation's users
229 | beyond what the individual works permit. Inclusion of a covered work
230 | in an aggregate does not cause this License to apply to the other
231 | parts of the aggregate.
232 |
233 | 6. Conveying Non-Source Forms.
234 |
235 | You may convey a covered work in object code form under the terms
236 | of sections 4 and 5, provided that you also convey the
237 | machine-readable Corresponding Source under the terms of this License,
238 | in one of these ways:
239 |
240 | a) Convey the object code in, or embodied in, a physical product
241 | (including a physical distribution medium), accompanied by the
242 | Corresponding Source fixed on a durable physical medium
243 | customarily used for software interchange.
244 |
245 | b) Convey the object code in, or embodied in, a physical product
246 | (including a physical distribution medium), accompanied by a
247 | written offer, valid for at least three years and valid for as
248 | long as you offer spare parts or customer support for that product
249 | model, to give anyone who possesses the object code either (1) a
250 | copy of the Corresponding Source for all the software in the
251 | product that is covered by this License, on a durable physical
252 | medium customarily used for software interchange, for a price no
253 | more than your reasonable cost of physically performing this
254 | conveying of source, or (2) access to copy the
255 | Corresponding Source from a network server at no charge.
256 |
257 | c) Convey individual copies of the object code with a copy of the
258 | written offer to provide the Corresponding Source. This
259 | alternative is allowed only occasionally and noncommercially, and
260 | only if you received the object code with such an offer, in accord
261 | with subsection 6b.
262 |
263 | d) Convey the object code by offering access from a designated
264 | place (gratis or for a charge), and offer equivalent access to the
265 | Corresponding Source in the same way through the same place at no
266 | further charge. You need not require recipients to copy the
267 | Corresponding Source along with the object code. If the place to
268 | copy the object code is a network server, the Corresponding Source
269 | may be on a different server (operated by you or a third party)
270 | that supports equivalent copying facilities, provided you maintain
271 | clear directions next to the object code saying where to find the
272 | Corresponding Source. Regardless of what server hosts the
273 | Corresponding Source, you remain obligated to ensure that it is
274 | available for as long as needed to satisfy these requirements.
275 |
276 | e) Convey the object code using peer-to-peer transmission, provided
277 | you inform other peers where the object code and Corresponding
278 | Source of the work are being offered to the general public at no
279 | charge under subsection 6d.
280 |
281 | A separable portion of the object code, whose source code is excluded
282 | from the Corresponding Source as a System Library, need not be
283 | included in conveying the object code work.
284 |
285 | A "User Product" is either (1) a "consumer product", which means any
286 | tangible personal property which is normally used for personal, family,
287 | or household purposes, or (2) anything designed or sold for incorporation
288 | into a dwelling. In determining whether a product is a consumer product,
289 | doubtful cases shall be resolved in favor of coverage. For a particular
290 | product received by a particular user, "normally used" refers to a
291 | typical or common use of that class of product, regardless of the status
292 | of the particular user or of the way in which the particular user
293 | actually uses, or expects or is expected to use, the product. A product
294 | is a consumer product regardless of whether the product has substantial
295 | commercial, industrial or non-consumer uses, unless such uses represent
296 | the only significant mode of use of the product.
297 |
298 | "Installation Information" for a User Product means any methods,
299 | procedures, authorization keys, or other information required to install
300 | and execute modified versions of a covered work in that User Product from
301 | a modified version of its Corresponding Source. The information must
302 | suffice to ensure that the continued functioning of the modified object
303 | code is in no case prevented or interfered with solely because
304 | modification has been made.
305 |
306 | If you convey an object code work under this section in, or with, or
307 | specifically for use in, a User Product, and the conveying occurs as
308 | part of a transaction in which the right of possession and use of the
309 | User Product is transferred to the recipient in perpetuity or for a
310 | fixed term (regardless of how the transaction is characterized), the
311 | Corresponding Source conveyed under this section must be accompanied
312 | by the Installation Information. But this requirement does not apply
313 | if neither you nor any third party retains the ability to install
314 | modified object code on the User Product (for example, the work has
315 | been installed in ROM).
316 |
317 | The requirement to provide Installation Information does not include a
318 | requirement to continue to provide support service, warranty, or updates
319 | for a work that has been modified or installed by the recipient, or for
320 | the User Product in which it has been modified or installed. Access to a
321 | network may be denied when the modification itself materially and
322 | adversely affects the operation of the network or violates the rules and
323 | protocols for communication across the network.
324 |
325 | Corresponding Source conveyed, and Installation Information provided,
326 | in accord with this section must be in a format that is publicly
327 | documented (and with an implementation available to the public in
328 | source code form), and must require no special password or key for
329 | unpacking, reading or copying.
330 |
331 | 7. Additional Terms.
332 |
333 | "Additional permissions" are terms that supplement the terms of this
334 | License by making exceptions from one or more of its conditions.
335 | Additional permissions that are applicable to the entire Program shall
336 | be treated as though they were included in this License, to the extent
337 | that they are valid under applicable law. If additional permissions
338 | apply only to part of the Program, that part may be used separately
339 | under those permissions, but the entire Program remains governed by
340 | this License without regard to the additional permissions.
341 |
342 | When you convey a copy of a covered work, you may at your option
343 | remove any additional permissions from that copy, or from any part of
344 | it. (Additional permissions may be written to require their own
345 | removal in certain cases when you modify the work.) You may place
346 | additional permissions on material, added by you to a covered work,
347 | for which you have or can give appropriate copyright permission.
348 |
349 | Notwithstanding any other provision of this License, for material you
350 | add to a covered work, you may (if authorized by the copyright holders of
351 | that material) supplement the terms of this License with terms:
352 |
353 | a) Disclaiming warranty or limiting liability differently from the
354 | terms of sections 15 and 16 of this License; or
355 |
356 | b) Requiring preservation of specified reasonable legal notices or
357 | author attributions in that material or in the Appropriate Legal
358 | Notices displayed by works containing it; or
359 |
360 | c) Prohibiting misrepresentation of the origin of that material, or
361 | requiring that modified versions of such material be marked in
362 | reasonable ways as different from the original version; or
363 |
364 | d) Limiting the use for publicity purposes of names of licensors or
365 | authors of the material; or
366 |
367 | e) Declining to grant rights under trademark law for use of some
368 | trade names, trademarks, or service marks; or
369 |
370 | f) Requiring indemnification of licensors and authors of that
371 | material by anyone who conveys the material (or modified versions of
372 | it) with contractual assumptions of liability to the recipient, for
373 | any liability that these contractual assumptions directly impose on
374 | those licensors and authors.
375 |
376 | All other non-permissive additional terms are considered "further
377 | restrictions" within the meaning of section 10. If the Program as you
378 | received it, or any part of it, contains a notice stating that it is
379 | governed by this License along with a term that is a further
380 | restriction, you may remove that term. If a license document contains
381 | a further restriction but permits relicensing or conveying under this
382 | License, you may add to a covered work material governed by the terms
383 | of that license document, provided that the further restriction does
384 | not survive such relicensing or conveying.
385 |
386 | If you add terms to a covered work in accord with this section, you
387 | must place, in the relevant source files, a statement of the
388 | additional terms that apply to those files, or a notice indicating
389 | where to find the applicable terms.
390 |
391 | Additional terms, permissive or non-permissive, may be stated in the
392 | form of a separately written license, or stated as exceptions;
393 | the above requirements apply either way.
394 |
395 | 8. Termination.
396 |
397 | You may not propagate or modify a covered work except as expressly
398 | provided under this License. Any attempt otherwise to propagate or
399 | modify it is void, and will automatically terminate your rights under
400 | this License (including any patent licenses granted under the third
401 | paragraph of section 11).
402 |
403 | However, if you cease all violation of this License, then your
404 | license from a particular copyright holder is reinstated (a)
405 | provisionally, unless and until the copyright holder explicitly and
406 | finally terminates your license, and (b) permanently, if the copyright
407 | holder fails to notify you of the violation by some reasonable means
408 | prior to 60 days after the cessation.
409 |
410 | Moreover, your license from a particular copyright holder is
411 | reinstated permanently if the copyright holder notifies you of the
412 | violation by some reasonable means, this is the first time you have
413 | received notice of violation of this License (for any work) from that
414 | copyright holder, and you cure the violation prior to 30 days after
415 | your receipt of the notice.
416 |
417 | Termination of your rights under this section does not terminate the
418 | licenses of parties who have received copies or rights from you under
419 | this License. If your rights have been terminated and not permanently
420 | reinstated, you do not qualify to receive new licenses for the same
421 | material under section 10.
422 |
423 | 9. Acceptance Not Required for Having Copies.
424 |
425 | You are not required to accept this License in order to receive or
426 | run a copy of the Program. Ancillary propagation of a covered work
427 | occurring solely as a consequence of using peer-to-peer transmission
428 | to receive a copy likewise does not require acceptance. However,
429 | nothing other than this License grants you permission to propagate or
430 | modify any covered work. These actions infringe copyright if you do
431 | not accept this License. Therefore, by modifying or propagating a
432 | covered work, you indicate your acceptance of this License to do so.
433 |
434 | 10. Automatic Licensing of Downstream Recipients.
435 |
436 | Each time you convey a covered work, the recipient automatically
437 | receives a license from the original licensors, to run, modify and
438 | propagate that work, subject to this License. You are not responsible
439 | for enforcing compliance by third parties with this License.
440 |
441 | An "entity transaction" is a transaction transferring control of an
442 | organization, or substantially all assets of one, or subdividing an
443 | organization, or merging organizations. If propagation of a covered
444 | work results from an entity transaction, each party to that
445 | transaction who receives a copy of the work also receives whatever
446 | licenses to the work the party's predecessor in interest had or could
447 | give under the previous paragraph, plus a right to possession of the
448 | Corresponding Source of the work from the predecessor in interest, if
449 | the predecessor has it or can get it with reasonable efforts.
450 |
451 | You may not impose any further restrictions on the exercise of the
452 | rights granted or affirmed under this License. For example, you may
453 | not impose a license fee, royalty, or other charge for exercise of
454 | rights granted under this License, and you may not initiate litigation
455 | (including a cross-claim or counterclaim in a lawsuit) alleging that
456 | any patent claim is infringed by making, using, selling, offering for
457 | sale, or importing the Program or any portion of it.
458 |
459 | 11. Patents.
460 |
461 | A "contributor" is a copyright holder who authorizes use under this
462 | License of the Program or a work on which the Program is based. The
463 | work thus licensed is called the contributor's "contributor version".
464 |
465 | A contributor's "essential patent claims" are all patent claims
466 | owned or controlled by the contributor, whether already acquired or
467 | hereafter acquired, that would be infringed by some manner, permitted
468 | by this License, of making, using, or selling its contributor version,
469 | but do not include claims that would be infringed only as a
470 | consequence of further modification of the contributor version. For
471 | purposes of this definition, "control" includes the right to grant
472 | patent sublicenses in a manner consistent with the requirements of
473 | this License.
474 |
475 | Each contributor grants you a non-exclusive, worldwide, royalty-free
476 | patent license under the contributor's essential patent claims, to
477 | make, use, sell, offer for sale, import and otherwise run, modify and
478 | propagate the contents of its contributor version.
479 |
480 | In the following three paragraphs, a "patent license" is any express
481 | agreement or commitment, however denominated, not to enforce a patent
482 | (such as an express permission to practice a patent or covenant not to
483 | sue for patent infringement). To "grant" such a patent license to a
484 | party means to make such an agreement or commitment not to enforce a
485 | patent against the party.
486 |
487 | If you convey a covered work, knowingly relying on a patent license,
488 | and the Corresponding Source of the work is not available for anyone
489 | to copy, free of charge and under the terms of this License, through a
490 | publicly available network server or other readily accessible means,
491 | then you must either (1) cause the Corresponding Source to be so
492 | available, or (2) arrange to deprive yourself of the benefit of the
493 | patent license for this particular work, or (3) arrange, in a manner
494 | consistent with the requirements of this License, to extend the patent
495 | license to downstream recipients. "Knowingly relying" means you have
496 | actual knowledge that, but for the patent license, your conveying the
497 | covered work in a country, or your recipient's use of the covered work
498 | in a country, would infringe one or more identifiable patents in that
499 | country that you have reason to believe are valid.
500 |
501 | If, pursuant to or in connection with a single transaction or
502 | arrangement, you convey, or propagate by procuring conveyance of, a
503 | covered work, and grant a patent license to some of the parties
504 | receiving the covered work authorizing them to use, propagate, modify
505 | or convey a specific copy of the covered work, then the patent license
506 | you grant is automatically extended to all recipients of the covered
507 | work and works based on it.
508 |
509 | A patent license is "discriminatory" if it does not include within
510 | the scope of its coverage, prohibits the exercise of, or is
511 | conditioned on the non-exercise of one or more of the rights that are
512 | specifically granted under this License. You may not convey a covered
513 | work if you are a party to an arrangement with a third party that is
514 | in the business of distributing software, under which you make payment
515 | to the third party based on the extent of your activity of conveying
516 | the work, and under which the third party grants, to any of the
517 | parties who would receive the covered work from you, a discriminatory
518 | patent license (a) in connection with copies of the covered work
519 | conveyed by you (or copies made from those copies), or (b) primarily
520 | for and in connection with specific products or compilations that
521 | contain the covered work, unless you entered into that arrangement,
522 | or that patent license was granted, prior to 28 March 2007.
523 |
524 | Nothing in this License shall be construed as excluding or limiting
525 | any implied license or other defenses to infringement that may
526 | otherwise be available to you under applicable patent law.
527 |
528 | 12. No Surrender of Others' Freedom.
529 |
530 | If conditions are imposed on you (whether by court order, agreement or
531 | otherwise) that contradict the conditions of this License, they do not
532 | excuse you from the conditions of this License. If you cannot convey a
533 | covered work so as to satisfy simultaneously your obligations under this
534 | License and any other pertinent obligations, then as a consequence you may
535 | not convey it at all. For example, if you agree to terms that obligate you
536 | to collect a royalty for further conveying from those to whom you convey
537 | the Program, the only way you could satisfy both those terms and this
538 | License would be to refrain entirely from conveying the Program.
539 |
540 | 13. Remote Network Interaction; Use with the GNU General Public License.
541 |
542 | Notwithstanding any other provision of this License, if you modify the
543 | Program, your modified version must prominently offer all users
544 | interacting with it remotely through a computer network (if your version
545 | supports such interaction) an opportunity to receive the Corresponding
546 | Source of your version by providing access to the Corresponding Source
547 | from a network server at no charge, through some standard or customary
548 | means of facilitating copying of software. This Corresponding Source
549 | shall include the Corresponding Source for any work covered by version 3
550 | of the GNU General Public License that is incorporated pursuant to the
551 | following paragraph.
552 |
553 | Notwithstanding any other provision of this License, you have
554 | permission to link or combine any covered work with a work licensed
555 | under version 3 of the GNU General Public License into a single
556 | combined work, and to convey the resulting work. The terms of this
557 | License will continue to apply to the part which is the covered work,
558 | but the work with which it is combined will remain governed by version
559 | 3 of the GNU General Public License.
560 |
561 | 14. Revised Versions of this License.
562 |
563 | The Free Software Foundation may publish revised and/or new versions of
564 | the GNU Affero General Public License from time to time. Such new versions
565 | will be similar in spirit to the present version, but may differ in detail to
566 | address new problems or concerns.
567 |
568 | Each version is given a distinguishing version number. If the
569 | Program specifies that a certain numbered version of the GNU Affero General
570 | Public License "or any later version" applies to it, you have the
571 | option of following the terms and conditions either of that numbered
572 | version or of any later version published by the Free Software
573 | Foundation. If the Program does not specify a version number of the
574 | GNU Affero General Public License, you may choose any version ever published
575 | by the Free Software Foundation.
576 |
577 | If the Program specifies that a proxy can decide which future
578 | versions of the GNU Affero General Public License can be used, that proxy's
579 | public statement of acceptance of a version permanently authorizes you
580 | to choose that version for the Program.
581 |
582 | Later license versions may give you additional or different
583 | permissions. However, no additional obligations are imposed on any
584 | author or copyright holder as a result of your choosing to follow a
585 | later version.
586 |
587 | 15. Disclaimer of Warranty.
588 |
589 | THERE IS NO WARRANTY FOR THE PROGRAM, TO THE EXTENT PERMITTED BY
590 | APPLICABLE LAW. EXCEPT WHEN OTHERWISE STATED IN WRITING THE COPYRIGHT
591 | HOLDERS AND/OR OTHER PARTIES PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY
592 | OF ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING, BUT NOT LIMITED TO,
593 | THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
594 | PURPOSE. THE ENTIRE RISK AS TO THE QUALITY AND PERFORMANCE OF THE PROGRAM
595 | IS WITH YOU. SHOULD THE PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF
596 | ALL NECESSARY SERVICING, REPAIR OR CORRECTION.
597 |
598 | 16. Limitation of Liability.
599 |
600 | IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
601 | WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MODIFIES AND/OR CONVEYS
602 | THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES, INCLUDING ANY
603 | GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF THE
604 | USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED TO LOSS OF
605 | DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY YOU OR THIRD
606 | PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER PROGRAMS),
607 | EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE POSSIBILITY OF
608 | SUCH DAMAGES.
609 |
610 | 17. Interpretation of Sections 15 and 16.
611 |
612 | If the disclaimer of warranty and limitation of liability provided
613 | above cannot be given local legal effect according to their terms,
614 | reviewing courts shall apply local law that most closely approximates
615 | an absolute waiver of all civil liability in connection with the
616 | Program, unless a warranty or assumption of liability accompanies a
617 | copy of the Program in return for a fee.
618 |
619 | END OF TERMS AND CONDITIONS
620 |
621 | How to Apply These Terms to Your New Programs
622 |
623 | If you develop a new program, and you want it to be of the greatest
624 | possible use to the public, the best way to achieve this is to make it
625 | free software which everyone can redistribute and change under these terms.
626 |
627 | To do so, attach the following notices to the program. It is safest
628 | to attach them to the start of each source file to most effectively
629 | state the exclusion of warranty; and each file should have at least
630 | the "copyright" line and a pointer to where the full notice is found.
631 |
632 |
633 | Copyright (C)
634 |
635 | This program is free software: you can redistribute it and/or modify
636 | it under the terms of the GNU Affero General Public License as published
637 | by the Free Software Foundation, either version 3 of the License, or
638 | (at your option) any later version.
639 |
640 | This program is distributed in the hope that it will be useful,
641 | but WITHOUT ANY WARRANTY; without even the implied warranty of
642 | MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
643 | GNU Affero General Public License for more details.
644 |
645 | You should have received a copy of the GNU Affero General Public License
646 | along with this program. If not, see .
647 |
648 | Also add information on how to contact you by electronic and paper mail.
649 |
650 | If your software can interact with users remotely through a computer
651 | network, you should also make sure that it provides a way for users to
652 | get its source. For example, if your program is a web application, its
653 | interface could display a "Source" link that leads users to an archive
654 | of the code. There are many ways you could offer source, and different
655 | solutions will be better for different programs; see section 13 for the
656 | specific requirements.
657 |
658 | You should also get your employer (if you work as a programmer) or school,
659 | if any, to sign a "copyright disclaimer" for the program, if necessary.
660 | For more information on this, and how to apply and follow the GNU AGPL, see
661 | .
662 |
--------------------------------------------------------------------------------
/README.md:
--------------------------------------------------------------------------------
1 | [](https://travis-ci.org/blitz/kernel_entry_benchmark)
2 | 
3 |
4 | # Kernel Entry Microbenchmarks
5 |
6 | Find the full description in my blog post about [x86 system call
7 | mechanisms](https://x86.lol/generic/2019/07/04/kernel-entry.html) over on
8 | [x86.lol](https://x86.lol/).
9 |
10 | This repository contains x86 kernel entry benchmarks for:
11 |
12 | - interrupt gates,
13 | - call gates,
14 | - `sysenter`/`sysexit`,
15 | - `syscall`/`sysret`.
16 |
17 | ## Building with Nix (Recommended)
18 |
19 | If you have [Nix](https://nixos.org/), you can build the measurement
20 | kernel like this:
21 |
22 | ```sh
23 | % nix-build ./ci.nix -A defaultPackage
24 | ```
25 |
26 | The kernel will then be `result` in the current directory.
27 |
28 | If you have Nix with
29 | [Flakes](https://nixos.wiki/wiki/Flakes#Non-NixOS) (still not enabled
30 | by default), this can be shortened to:
31 |
32 | ```sh
33 | % nix build
34 | ```
35 |
36 | ## Building without Nix
37 |
38 | For building and running without Nix you need:
39 |
40 | - gcc >= 7.x
41 | - make
42 |
43 | Then you can just invoke make to build the kernel:
44 |
45 | ```sh
46 | % make -C src
47 | ```
48 |
49 | Then you can find the kernel as `src/kernel_entry_benchmark.elf32`.
50 |
51 | Whether this works is up to your system. Only the Nix build is tested.
52 |
53 | ## Running Benchmarks
54 |
55 | The tiny benchmark kernel assumes that it runs on Qemu and can use the
56 | Qemu debug console. You can run it as a Multiboot-compatible kernel:
57 |
58 | ```sh
59 | % qemu-system-x86_64 -kernel result -debugcon stdio -no-reboot -enable-kvm
60 | Interrupt Gate,610
61 | Call Gate,473
62 | Syscall,99
63 | ```
64 |
65 | The output is in CSV format. The first column is the kernel entry
66 | method and the second is the length of a roundtrip to the kernel using
67 | this method in cycles.
68 |
69 | I leave implementing serial output and running it on real hardware as
70 | an exercise to the reader.
71 |
72 | **Note:** Only Intel CPUs work currently. There seems to be an issue
73 | on AMD CPUs that currently limit this benchmark from running there.
74 |
--------------------------------------------------------------------------------
/benchmark.nix:
--------------------------------------------------------------------------------
1 | { runCommand, benchmark-run, benchmark-plot }:
2 | runCommand "benchmark-result" {
3 | nativeBuildInputs = [ benchmark-run benchmark-plot ];
4 | requiredSystemFeatures = [ "kvm" ];
5 | } ''
6 |
7 | echo $PATH
8 | mkdir -p $out
9 | benchmark-run | tee $out/benchmark.csv
10 |
11 | if [ -z "$(cat $out/benchmark.csv)" ]; then
12 | echo "VM produced no output?"
13 | exit 1
14 | fi
15 |
16 | cat $out/benchmark.csv | benchmark-plot $out/benchmark.png
17 | ''
18 |
--------------------------------------------------------------------------------
/build.nix:
--------------------------------------------------------------------------------
1 | { stdenv, gnumake, nasm }:
2 |
3 | stdenv.mkDerivation {
4 | name = "kernel-entry-benchmark";
5 | src = ./src;
6 | nativeBuildInputs = [ gnumake nasm ];
7 |
8 | installPhase = ''
9 | runHook preInstall
10 |
11 | install -m 444 kernel_entry_benchmark.elf32 $out
12 |
13 | runHook postInstall
14 | '';
15 | }
16 |
--------------------------------------------------------------------------------
/ci.nix:
--------------------------------------------------------------------------------
1 | (import ./flake-compat.nix).defaultNix.ciNix
2 |
3 |
--------------------------------------------------------------------------------
/flake-compat.nix:
--------------------------------------------------------------------------------
1 | let
2 | lock = builtins.fromJSON (builtins.readFile ./flake.lock);
3 | inherit (lock.nodes.flake-compat.locked) owner repo rev narHash;
4 | flake-compat = builtins.fetchTarball {
5 | url = "https://github.com/${owner}/${repo}/archive/${rev}.tar.gz";
6 | sha256 = narHash;
7 | };
8 | in
9 | import flake-compat { src = ./.; }
10 |
--------------------------------------------------------------------------------
/flake.lock:
--------------------------------------------------------------------------------
1 | {
2 | "nodes": {
3 | "flake-compat": {
4 | "flake": false,
5 | "locked": {
6 | "lastModified": 1641205782,
7 | "narHash": "sha256-4jY7RCWUoZ9cKD8co0/4tFARpWB+57+r1bLLvXNJliY=",
8 | "owner": "edolstra",
9 | "repo": "flake-compat",
10 | "rev": "b7547d3eed6f32d06102ead8991ec52ab0a4f1a7",
11 | "type": "github"
12 | },
13 | "original": {
14 | "owner": "edolstra",
15 | "repo": "flake-compat",
16 | "type": "github"
17 | }
18 | },
19 | "flake-compat-ci": {
20 | "locked": {
21 | "lastModified": 1641672839,
22 | "narHash": "sha256-Bdwv+DKeEMlRNPDpZxSz0sSrqQBvdKO5fZ8LmvrgCOU=",
23 | "owner": "hercules-ci",
24 | "repo": "flake-compat-ci",
25 | "rev": "e832114bc18376c0f3fa13c19bf5ff253cc6570a",
26 | "type": "github"
27 | },
28 | "original": {
29 | "owner": "hercules-ci",
30 | "repo": "flake-compat-ci",
31 | "type": "github"
32 | }
33 | },
34 | "nixpkgs": {
35 | "locked": {
36 | "lastModified": 1645010845,
37 | "narHash": "sha256-hO9X4PvxkSLMQnGGB7tOrKPwufhLMiNQMNXNwzLqneo=",
38 | "owner": "NixOS",
39 | "repo": "nixpkgs",
40 | "rev": "2128d0aa28edef51fd8fef38b132ffc0155595df",
41 | "type": "github"
42 | },
43 | "original": {
44 | "owner": "NixOS",
45 | "ref": "nixos-21.11",
46 | "repo": "nixpkgs",
47 | "type": "github"
48 | }
49 | },
50 | "root": {
51 | "inputs": {
52 | "flake-compat": "flake-compat",
53 | "flake-compat-ci": "flake-compat-ci",
54 | "nixpkgs": "nixpkgs"
55 | }
56 | }
57 | },
58 | "root": "root",
59 | "version": 7
60 | }
61 |
--------------------------------------------------------------------------------
/flake.nix:
--------------------------------------------------------------------------------
1 | {
2 | description = "A very basic flake";
3 |
4 | inputs = {
5 | nixpkgs.url = "github:NixOS/nixpkgs/nixos-21.11";
6 | flake-compat = {
7 | url = "github:edolstra/flake-compat";
8 | flake = false;
9 | };
10 | flake-compat-ci.url = "github:hercules-ci/flake-compat-ci";
11 | };
12 |
13 | outputs = { self, nixpkgs, flake-compat, flake-compat-ci }: {
14 |
15 | packages.x86_64-linux =
16 | let
17 | callPackage = nixpkgs.legacyPackages.x86_64-linux.callPackage;
18 | in rec {
19 | kernel-entry-benchmark = callPackage ./build.nix {};
20 |
21 | benchmark-plot = callPackage ./plot.nix {};
22 | benchmark-run = callPackage ./run.nix {
23 | inherit kernel-entry-benchmark;
24 | };
25 |
26 | benchmark-results = callPackage ./benchmark.nix {
27 | inherit benchmark-run benchmark-plot;
28 | };
29 | };
30 |
31 | defaultPackage.x86_64-linux = self.packages.x86_64-linux.kernel-entry-benchmark;
32 |
33 | # For Hercules CI, which doesn't natively support flakes (yet).
34 | ciNix = flake-compat-ci.lib.recurseIntoFlakeWith {
35 | flake = self;
36 |
37 | # Optional. Systems for which to perform CI.
38 | systems = [ "x86_64-linux" ];
39 | };
40 | };
41 | }
42 |
--------------------------------------------------------------------------------
/plot.nix:
--------------------------------------------------------------------------------
1 | { stdenvNoCC, python3, lib, makeWrapper }:
2 |
3 | stdenvNoCC.mkDerivation {
4 | name = "benchmark-run";
5 |
6 | src = ./scripts;
7 |
8 | nativeBuildInputs = [ makeWrapper ];
9 | buildInputs = [ (python3.withPackages (ps: [ ps.matplotlib ])) ];
10 |
11 | dontConfigure = true;
12 | dontBuild = true;
13 |
14 | installPhase = ''
15 | runHook preInstall
16 |
17 | mkdir -p $out/bin
18 |
19 | patchShebangs plot
20 | install -m 0755 plot $out/bin/benchmark-plot
21 |
22 | runHook postInstall
23 | '';
24 | }
25 |
--------------------------------------------------------------------------------
/run.nix:
--------------------------------------------------------------------------------
1 | { stdenvNoCC, qemu, util-linux, lib, makeWrapper
2 | , kernel-entry-benchmark }:
3 |
4 | stdenvNoCC.mkDerivation {
5 | name = "benchmark-run";
6 |
7 | src = ./scripts;
8 |
9 | nativeBuildInputs = [ makeWrapper ];
10 | buildInputs = [ qemu ];
11 |
12 | dontConfigure = true;
13 | dontBuild = true;
14 |
15 | installPhase = ''
16 | runHook preInstall
17 |
18 | mkdir -p $out/bin
19 |
20 | patchShebangs run
21 | install -m 0755 run $out/bin/benchmark-run
22 | wrapProgram $out/bin/benchmark-run --prefix PATH : ${lib.makeBinPath [ qemu util-linux ]} \
23 | --add-flags '${kernel-entry-benchmark}'
24 |
25 | runHook postInstall
26 | '';
27 | }
28 |
--------------------------------------------------------------------------------
/scripts/plot:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env python3
2 |
3 | # Plot a CSV file with label value pairs.
4 |
5 | import csv
6 | import sys
7 |
8 | import matplotlib
9 | matplotlib.use('Agg') # Otherwise, we crash without $DISPLAY set
10 |
11 | import matplotlib.pyplot as plt; plt.rcdefaults()
12 | import numpy as np
13 | import matplotlib.pyplot as plt
14 |
15 | output_file = sys.argv[1]
16 |
17 | reader = csv.reader(sys.stdin)
18 |
19 | labels = []
20 | values = []
21 |
22 | for row in reader:
23 | # Ignore comments
24 | if row[0].startswith('#'):
25 | continue
26 |
27 | labels.append(row[0])
28 | values.append(int(row[1]))
29 |
30 | y_pos = np.arange(len(labels))
31 |
32 | plt.bar(y_pos, values, align='center', alpha=0.5)
33 | plt.xticks(y_pos, labels)
34 | plt.ylabel('Cycles')
35 | plt.title('System call roundtrip')
36 |
37 | plt.savefig(output_file)
38 |
39 |
--------------------------------------------------------------------------------
/scripts/run:
--------------------------------------------------------------------------------
1 | #!/usr/bin/env bash
2 |
3 | set -e -u
4 |
5 | if [ $# -lt 1 ]; then
6 | echo "Usage: $0 boot-target"
7 | exit 1
8 | fi
9 |
10 | KERNEL=$1
11 |
12 | if [ -r /dev/kvm ]; then
13 | QEMUARGS="-machine q35,accel=kvm"
14 | echo "Using KVM." > /dev/stderr
15 | else
16 | QEMUARGS="-machine q35,accel=tcg"
17 | echo "No KVM available." > /dev/stderr
18 | fi
19 |
20 | # Pin to one processor to get more stable numbers.
21 | exec taskset -c $(($(nproc) - 1)) \
22 | qemu-system-x86_64 -cpu qemu64 -net none \
23 | $QEMUARGS \
24 | -display none -smp 1 -no-reboot -vga none -debugcon stdio -kernel "$KERNEL" -s
25 |
--------------------------------------------------------------------------------
/src/Makefile:
--------------------------------------------------------------------------------
1 | NASM ?= nasm
2 |
3 | DEPDIR := .deps
4 | DEPFLAGS = -MT $@ -MMD -MP -MF $(DEPDIR)/$*.d
5 |
6 | ASFLAGS += -g -f elf64 -F dwarf
7 |
8 | CPPFLAGS = -nostdinc -I.
9 |
10 | CXXFLAGS += -g -O2 -march=x86-64 -mtune=broadwell -std=c++20 -Wall -nostdinc++
11 | CXXFLAGS += -mno-red-zone
12 |
13 | # Newer compilers can do -mgeneral-regs-only, but for old ones we have to do:
14 | CXXFLAGS += -mno-mmx -mno-sse -mno-sse2 -mno-avx -mno-avx2
15 |
16 | CXXFLAGS += -ffreestanding -fno-asynchronous-unwind-tables -fno-threadsafe-statics -fno-rtti -fno-exceptions
17 | CXXFLAGS += -fno-PIC -fno-stack-protector
18 |
19 | LDFLAGS = -static -no-pie -g -nostdlib -Wl,--build-id=none -Wl,-n -Wl,-T
20 |
21 | OBJS := entry.o io.o main.o start.o
22 |
23 | kernel_entry_benchmark.elf32: kernel_entry_benchmark.elf64
24 | $(OBJCOPY) -O elf32-i386 $< $@
25 | $(STRIP) $@
26 |
27 | kernel_entry_benchmark.elf64: standalone.lds $(OBJS)
28 | $(CXX) $(CXXFLAGS) $(CFLAGS) $(LDFLAGS) $^ -o $@
29 |
30 | .PHONY: clean
31 | clean:
32 | rm -f $(OBJS) kernel_entry_benchmark.elf64
33 |
34 | %.o : %.cpp $(DEPDIR)/%.d | $(DEPDIR)
35 | $(CXX) -c $(DEPFLAGS) $(CXXFLAGS) $(CFLAGS) $(CPPFLAGS) $< -o $@
36 |
37 | %.o : %.asm
38 | $(NASM) $(ASFLAGS) $< -o $@
39 |
40 | $(DEPDIR): ; @mkdir -p $@
41 |
42 | DEPFILES := $(SRCS:%.c=$(DEPDIR)/%.d)
43 | $(DEPFILES):
44 | include $(wildcard $(DEPFILES))
45 |
--------------------------------------------------------------------------------
/src/dt.hpp:
--------------------------------------------------------------------------------
1 | // x86_64 CPU data structures and helper functions
2 |
3 | #pragma once
4 |
5 | #include "types.hpp"
6 | #include "x86-instructions.hpp"
7 |
8 | // Task State Segment
9 | struct tss {
10 | uint32_t reserved0 = 0;
11 | uint64_t rsp[3] {};
12 | uint32_t reserved1 = 0;
13 | uint32_t reserved2 = 0;
14 | uint64_t ist[7] {};
15 | uint32_t reserved3 = 0;
16 | uint32_t reserved4 = 0;
17 | uint16_t reserved5 = 0;
18 | uint16_t iopb_offset = 0;
19 | } __packed;
20 |
21 | // A descriptor for the Global Descriptor Table
22 | struct gdt_desc {
23 | uint16_t limit_lo = 0;
24 | uint16_t base_lo = 0;
25 | uint8_t base_mid = 0;
26 | uint8_t type_dpl = 0;
27 | uint8_t limit_flags = 0;
28 | uint8_t base_hi = 0;
29 |
30 | constexpr gdt_desc() = default;
31 |
32 | constexpr void set_base(uint64_t base)
33 | {
34 | base_lo = base & 0xFFFF;
35 | base_mid = (base >> 16) & 0xFF;
36 | base_hi = (base >> 24) & 0xFF;
37 | }
38 |
39 | static gdt_desc tss_desc(tss const *base)
40 | {
41 | gdt_desc t;
42 |
43 | static_assert(sizeof(tss) < 0x10000U, "TSS size broken");
44 |
45 | t.limit_lo = sizeof(tss) & 0xFFFF;
46 | t.type_dpl = 0b10001001;
47 | t.set_base((uintptr_t)base);
48 | return t;
49 | }
50 |
51 | static gdt_desc tss_desc_hi(tss const *base)
52 | {
53 | union bare_access {
54 | gdt_desc t;
55 | uint32_t dword[2];
56 |
57 | bare_access() {}
58 | } b;
59 |
60 | b.dword[0] = reinterpret_cast(base) >> 32;
61 | b.dword[1] = 0;
62 |
63 | return b.t;
64 | }
65 |
66 | static gdt_desc call_gate(uint16_t sel_, uint64_t offset_, uint8_t dpl)
67 | {
68 | gdt_desc i;
69 |
70 | i.limit_lo = offset_ & 0xFFFF;
71 | i.base_lo = sel_;
72 | i.type_dpl = 0b10001100 | (dpl << 5);
73 |
74 | i.limit_flags = (offset_ >> 16) & 0xFF;
75 | i.base_hi = (offset_ >> 24) & 0xFF;
76 |
77 | return i;
78 | }
79 |
80 | static gdt_desc call_gate_hi(uint64_t offset_)
81 | {
82 | gdt_desc i;
83 |
84 | union bare_access {
85 | gdt_desc t;
86 | uint32_t dword[2];
87 |
88 | bare_access() {}
89 | } b;
90 |
91 | b.dword[0] = offset_ >> 32;
92 | b.dword[1] = 0;
93 |
94 | return b.t;
95 | }
96 |
97 | constexpr static gdt_desc kern_code_desc()
98 | {
99 | gdt_desc t;
100 | t.type_dpl = 0b10011011;
101 | t.limit_flags = 0b10100000;
102 | return t;
103 | }
104 |
105 | constexpr static gdt_desc kern_data_desc()
106 | {
107 | gdt_desc t;
108 | t.type_dpl = 0b10010011;
109 | t.limit_flags = 0b10100000;
110 | return t;
111 | }
112 |
113 | constexpr static gdt_desc user_code_desc()
114 | {
115 | gdt_desc t;
116 | t.type_dpl = 0b11111011;
117 | t.limit_flags = 0b10100000;
118 | return t;
119 | }
120 |
121 | constexpr static gdt_desc user_data_desc()
122 | {
123 | gdt_desc t;
124 | t.type_dpl = 0b11110011;
125 | t.limit_flags = 0b10100000;
126 | return t;
127 | }
128 | };
129 |
130 | static_assert(sizeof(gdt_desc) == 8, "GDT structure broken");
131 |
132 | // Interrupt descriptor table descriptor
133 | struct idt_desc {
134 | uint16_t offset_lo = 0;
135 | uint16_t selector = 0;
136 | uint16_t flags = 0;
137 | uint16_t offset_hi = 0;
138 | uint32_t offset_hi2 = 0;
139 | uint32_t reserved = 0;
140 |
141 | idt_desc() = default;
142 |
143 | void set_offset(uint64_t offset_)
144 | {
145 | offset_lo = offset_ & 0xFFFF;
146 | offset_hi = (offset_ >> 16) & 0xFFFF;
147 | offset_hi2 = offset_ >> 32;
148 | }
149 |
150 | static idt_desc interrupt_gate(uint16_t sel_, uint64_t offset_, uint8_t ist, uint8_t dpl)
151 | {
152 | idt_desc i;
153 | i.set_offset(offset_);
154 | i.selector = sel_;
155 | i.flags = ist | (14 /* type */ << 8) | (dpl << 13) | (1 << 15 /* Present */);
156 | return i;
157 | }
158 | };
159 |
160 | // Descriptor table register (GDTR/LDTR)
161 | template
162 | struct dtr {
163 | uint16_t length;
164 | DESC const *descp;
165 |
166 | template
167 | dtr(DESC const (&descp_)[N])
168 | : length(N * sizeof(DESC) - 1),
169 | descp(descp_)
170 | {}
171 | } __packed;
172 |
173 | inline void lidt(dtr const &idtr)
174 | {
175 | asm volatile ("lidt %0" :: "m" (idtr));
176 | }
177 |
178 | inline void lgdt(dtr const &gdtr)
179 | {
180 | asm volatile ("lgdt %0" :: "m" (gdtr));
181 | }
182 |
183 | inline void ltr(uint16_t selector)
184 | {
185 | asm volatile ("ltr %0" :: "r" ((uint16_t)selector));
186 | }
187 |
--------------------------------------------------------------------------------
/src/entry.asm:
--------------------------------------------------------------------------------
1 | ; -*- Mode: nasm -*-
2 |
3 | extern call_gate_entry, int_gate_entry, syscall_entry, sysenter_entry
4 | extern kern_stack_end
5 |
6 | global asm_call_gate_entry, asm_int_gate_entry, asm_syscall_entry, asm_sysenter_entry
7 |
8 | section .text.asm_call_gate_entry
9 |
10 | align 16
11 | asm_call_gate_entry:
12 | o64 retf
13 |
14 | align 16
15 | asm_int_gate_entry:
16 | iretq
17 |
18 | align 16
19 | asm_syscall_entry:
20 | ; The hardware sets RIP and clobbers RCX/R11.
21 | o64 sysret
22 |
23 | align 16
24 | asm_sysenter_entry:
25 | ; Hardware sets RIP and RSP. Userspace has to give us RIP and userspace
26 | ; RSP to jump back via RDX/RCX.
27 | o64 sysexit
28 |
--------------------------------------------------------------------------------
/src/io.cpp:
--------------------------------------------------------------------------------
1 | #include
2 | #include
3 |
4 | void putc(char c)
5 | {
6 | outbi<0xe9>(c);
7 | }
8 |
9 | void put(const char *str)
10 | {
11 | // Qemu debugcon
12 | for (;*str != 0; str++)
13 | putc(*str);
14 | }
15 |
16 | void put(uint64_t v)
17 | {
18 | char digits[32] {};
19 |
20 | // Points at last character. We have to keep a '\0' at the end.
21 | char *cur = &digits[31];
22 |
23 | do {
24 | *(--cur) = v % 10 + '0';
25 | v = v / 10;
26 | } while (v);
27 |
28 | put(cur);
29 | }
30 |
31 | const char *hex(uint64_t v)
32 | {
33 | bool skip_leading_zeroes = true;
34 | static char digits[2 /* 0x */ + 16 /* hex digits */ + 1 /* \0 */];
35 | char *cur = &digits[0];
36 |
37 | *(cur++) = '0';
38 | *(cur++) = 'x';
39 |
40 | for (int i = sizeof(v)*8 - 4; i >= 0; i -= 4) {
41 | int nibble = (v >> i) & 0xF;
42 |
43 | // Don't print leading zeroes.
44 | if (nibble == 0 and i != 0 and skip_leading_zeroes)
45 | continue;
46 | else
47 | skip_leading_zeroes = false;
48 |
49 | *(cur++) = nibble + (nibble < 0xa ? '0' : 'a' - 0xa);
50 | }
51 |
52 | *(cur++) = 0;
53 | return &digits[0];
54 | }
55 |
--------------------------------------------------------------------------------
/src/io.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "types.hpp"
4 |
5 | void putc(char c);
6 |
7 | void put(const char *str);
8 | void put(uint64_t v);
9 |
10 | // The returned pointer is only valid till the next call to hex().
11 | const char *hex(uint64_t v);
12 |
13 | template
14 | void format(T first)
15 | {
16 | put(first);
17 | }
18 |
19 | template
20 | void format(T first, R... rest)
21 | {
22 | format(first);
23 | format(rest...);
24 | }
25 |
--------------------------------------------------------------------------------
/src/main.cpp:
--------------------------------------------------------------------------------
1 | #include
2 | #include
3 | #include
4 | #include
5 | #include
6 |
7 | extern "C" void asm_call_gate_entry();
8 | extern "C" void asm_int_gate_entry();
9 | extern "C" void asm_syscall_entry();
10 | extern "C" void asm_sysenter_entry();
11 | extern "C" char kern_stack_end[];
12 |
13 | extern "C" [[noreturn]] void main();
14 | extern "C" void call_gate_entry();
15 |
16 | extern "C" gdt_desc gdt[];
17 |
18 |
19 | alignas(64) char user_stack[128];
20 |
21 | gdt_desc gdt[] {
22 | {},
23 | gdt_desc::kern_code_desc(),
24 | gdt_desc::kern_data_desc(),
25 | gdt_desc::user_code_desc(),
26 | gdt_desc::user_data_desc(),
27 | gdt_desc::user_code_desc(), // Duplicated because of syscall/sysret selector requirements
28 |
29 | // TSS placeholders
30 | {}, {},
31 |
32 | // Call gate placeholders
33 | {}, {},
34 | };
35 |
36 | tss tss;
37 |
38 | static const uint8_t INT_GATE_VECTOR {32};
39 |
40 | static idt_desc idt[256];
41 |
42 | [[noreturn]] static void exit_via_retf(uint64_t user_rip)
43 | {
44 | asm volatile ("push %[user_ss]\n"
45 | "push %[user_rsp]\n"
46 | "push %[user_cs]\n"
47 | "push %[user_rip]\n"
48 | // Address width for far ret is 32-bit even in 64-bit mode.
49 | "rex.W lret\n"
50 | :
51 | : [user_ss] "ri" (static_cast(ring3_data_selector)),
52 | [user_rsp] "ri" (reinterpret_cast(user_stack) + sizeof(user_stack)),
53 | [user_cs] "ri" (static_cast(ring3_code_selector)),
54 | [user_rip] "ri" (user_rip));
55 |
56 | __builtin_unreachable();
57 | }
58 |
59 | static void do_gate_call()
60 | {
61 | struct farp {
62 | uint32_t offset;
63 | uint16_t sel;
64 | } __packed;
65 |
66 | static const farp gate { 0, ring3_call_selector };
67 | // Adding a rex.W prefix to the far call, makes the far pointer have
68 | // a 64-bit offset on Intel, but has no effect on AMD.
69 | asm volatile ("lcall *%[far_ptr]\n" :: [far_ptr] "m" (gate));
70 | }
71 |
72 | static void do_int()
73 | {
74 | asm volatile ("int %[vec]\n" :: [vec] "i" (INT_GATE_VECTOR));
75 | }
76 |
77 | static void do_syscall()
78 | {
79 | asm volatile ("syscall\n" ::: "rcx", "r11");
80 | }
81 |
82 | static void do_sysenter()
83 | {
84 | asm volatile ("mov %%rsp, %%rcx\n"
85 | "lea 1f(%%rip), %%rdx\n"
86 | "sysenter\n"
87 | "1: \n"
88 | ::: "rcx", "rdx");
89 | }
90 |
91 | static void measure(const char *name, void (*fn)())
92 | {
93 | const int measure_rounds = 128 * 1024;
94 | const int warmup_rounds = 32 * 1024;
95 |
96 | for (int warm_up = warmup_rounds; warm_up != 0; warm_up--) {
97 | fn();
98 | }
99 |
100 | uint64_t start = rdtsc();
101 | for (int rounds = measure_rounds; rounds != 0; rounds--) {
102 | fn();
103 | }
104 | uint64_t end = rdtsc();
105 |
106 | format(name, ",", (end - start) / measure_rounds, "\n");
107 | }
108 |
109 | [[noreturn]] static void user_measure()
110 | {
111 | measure("Interrupt Gate", [] () { do_int(); });
112 | measure("Call Gate", [] () { do_gate_call(); });
113 | measure("Syscall", [] () { do_syscall(); });
114 |
115 | // This only works on Intel.
116 | if (is_vendor_intel(query_cpuid(0))) {
117 | measure("Sysenter", [] () { do_sysenter(); });
118 | } else {
119 | format("# Only Intel supports sysenter in Long Mode, skipping.\n");
120 | }
121 |
122 | // We're done.
123 | outbi<0x64>(0xFE); // PCI reset on qemu
124 | cli_hlt(); // This will triple fault
125 | __builtin_unreachable();
126 | }
127 |
128 | static void allow_user_io()
129 | {
130 | // Set IOPL to 3.
131 | asm volatile ("pushfq\n"
132 | "or %0, (%%rsp)\n"
133 | "popfq\n"
134 | :
135 | : "r" (3 << 12));
136 | }
137 |
138 | static void init_syscall()
139 | {
140 | wrmsr(IA32_LSTAR, reinterpret_cast(asm_syscall_entry));
141 |
142 | static_assert(ring0_code_selector + 0x8 == ring0_data_selector,
143 | "Ring0 code and data selectors do not match SYSRET layout");
144 |
145 | static_assert(ring3_data_selector + 0x8 == ring3_code_selector,
146 | "Ring0 code and data selectors do not match SYSRET layout");
147 |
148 | wrmsr(IA32_STAR, ((uint64_t)ring0_code_selector << 32) | (uint64_t)(ring3_code_selector - 0x10) << 48);
149 | wrmsr(IA32_FMASK, 0x700); // Clear TF/DF/IF on system call entry
150 | }
151 |
152 | static void init_sysenter()
153 | {
154 | static_assert(ring0_code_selector + 0x8 == ring0_data_selector,
155 | "Ring0 code and data selectors do not match SYSCALL layout");
156 |
157 | static_assert(ring0_code_selector + 0x10 + 3 == ring3_code_selector_sysenter,
158 | "Ring0 code and ring3 code selectors do not match SYSCALL layout");
159 |
160 | static_assert(ring0_code_selector + 0x18 + 3 == ring3_data_selector,
161 | "Ring0 code and ring3 data selectors do not match SYSCALL layout");
162 |
163 | wrmsr(IA32_SYSENTER_CS, ring0_code_selector);
164 | wrmsr(IA32_SYSENTER_ESP, reinterpret_cast(kern_stack_end));
165 | wrmsr(IA32_SYSENTER_EIP, reinterpret_cast(asm_sysenter_entry));
166 | }
167 |
168 | void main()
169 | {
170 | // Finishing GDT with entries that cannot be constructed without runtime code.
171 | gdt[array_size(gdt) - 4] = gdt_desc::tss_desc(&tss);
172 | gdt[array_size(gdt) - 3] = gdt_desc::tss_desc_hi(&tss);
173 |
174 | gdt[array_size(gdt) - 2] = gdt_desc::call_gate(ring0_code_selector, reinterpret_cast(&asm_call_gate_entry), 3);
175 | gdt[array_size(gdt) - 1] = gdt_desc::call_gate_hi(reinterpret_cast(&asm_call_gate_entry));
176 |
177 | tss.rsp[0] = reinterpret_cast(kern_stack_end);
178 | ltr(ring0_tss_selector);
179 |
180 | // Prepare interrupt and call gate entry points
181 | idt[INT_GATE_VECTOR] = idt_desc::interrupt_gate(ring0_code_selector, reinterpret_cast(&asm_int_gate_entry), 0, 3);
182 | lidt(idt);
183 |
184 | allow_user_io();
185 | init_syscall();
186 | init_sysenter();
187 |
188 | exit_via_retf(reinterpret_cast(&user_measure));
189 |
190 | cli_hlt();
191 | }
192 |
--------------------------------------------------------------------------------
/src/msr.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "types.hpp"
4 |
5 | enum : uint32_t {
6 | IA32_SYSENTER_CS = 0x174U,
7 | IA32_SYSENTER_ESP = 0x175U,
8 | IA32_SYSENTER_EIP = 0x176U,
9 | IA32_STAR = 0xC0000081U,
10 | IA32_LSTAR = 0xC0000082U,
11 | IA32_FMASK = 0xC0000084U,
12 | IA32_FS_BASE = 0xC0000100U,
13 | };
14 |
--------------------------------------------------------------------------------
/src/selectors.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "types.hpp"
4 |
5 | const uint16_t ring0_code_selector = 0x8;
6 | const uint16_t ring0_data_selector = 0x10;
7 | const uint16_t ring3_code_selector_sysenter = 0x1b;
8 | const uint16_t ring3_data_selector = 0x23;
9 | const uint16_t ring3_code_selector = 0x2b;
10 | const uint16_t ring0_tss_selector = 0x30;
11 | const uint16_t ring3_call_selector = 0x43;
12 |
13 | inline bool is_cpl0_selector(uint16_t sel)
14 | {
15 | return (sel & 0x3) == 0;
16 | }
17 |
--------------------------------------------------------------------------------
/src/standalone.lds:
--------------------------------------------------------------------------------
1 | OUTPUT_FORMAT("elf64-x86-64")
2 | OUTPUT_ARCH("i386:x86-64")
3 | ENTRY(_start)
4 | EXTERN(_start)
5 |
6 | PHDRS {
7 | lo_rwx PT_LOAD FILEHDR PHDRS FLAGS (7); /* RWX */
8 | }
9 |
10 | SECTIONS
11 | {
12 | ENTRY(_start)
13 |
14 | /* 2 MB */
15 | .text (0x200000 + SIZEOF_HEADERS) :
16 | {
17 | *(.text.init)
18 | *(.text .text.*)
19 | } : lo_rwx
20 |
21 | .data :
22 | {
23 | . = ALIGN(8);
24 | _init_array_start = .;
25 | KEEP(*(SORT_BY_INIT_PRIORITY(.init_array.*)))
26 | KEEP(*(.init_array))
27 | _init_array_end = .;
28 | *(.rodata .rodata.*);
29 | *(.data .data.*);
30 | } : lo_rwx
31 |
32 | .bss :
33 | {
34 | *(.bss .bss.*);
35 | } : lo_rwx
36 |
37 | /DISCARD/ :
38 | {
39 | *(.comment)
40 | *(.eh_frame)
41 | *(.note.*)
42 | }
43 | }
44 |
--------------------------------------------------------------------------------
/src/start.asm:
--------------------------------------------------------------------------------
1 | ; -*- Mode: nasm -*-
2 |
3 | extern _init_array_start, _init_array_end
4 | extern main
5 | extern gdt
6 |
7 | %define PAGE_SIZE 4096
8 | %define PTE_P (1 << 0)
9 | %define PTE_W (1 << 1)
10 | %define PTE_U (1 << 2)
11 | %define PTE_A (1 << 5)
12 | %define PTE_D (1 << 6)
13 | %define PTE_PS (1 << 7)
14 | %define PTE_G (1 << 8)
15 |
16 | %define PTE_DEFAULT (PTE_P | PTE_W | PTE_U | PTE_A | PTE_D)
17 |
18 | %define IA32_EFER 0xC0000080
19 | %define IA32_EFER_SCE (1 << 0)
20 | %define IA32_EFER_LME (1 << 8)
21 | %define IA32_EFER_NXE (1 << 11)
22 |
23 | %define CR0_PE (1 << 0)
24 | %define CR0_MP (1 << 1)
25 | %define CR0_TS (1 << 3)
26 | %define CR0_NE (1 << 5)
27 | %define CR0_WP (1 << 16)
28 | %define CR0_PG (1 << 31)
29 |
30 | %define CR4_PAE (1 << 5)
31 | %define CR4_PGE (1 << 7)
32 |
33 | %define RING0_CODE_SELECTOR 0x08
34 | %define RING0_DATA_SELECTOR 0x10
35 | %define GDT_SIZE 0x50
36 |
37 | section .text.init progbits alloc exec nowrite
38 | bits 32
39 |
40 | _mbheader:
41 | align 4
42 | dd 1BADB002h ; magic
43 | dd 3h ; features
44 | dd -(3h + 1BADB002h) ; checksum
45 |
46 | _gdtp:
47 | dw GDT_SIZE - 1
48 | dd gdt
49 |
50 | global _start
51 | _start:
52 | ; Construct 1:1 2MB mapping at 2MB
53 | mov dword [ptab_pml4], ptab_pdpt + PTE_DEFAULT ; PTE_G is reserved in PML4 on AMD.
54 | mov dword [ptab_pdpt], ptab_pd + PTE_DEFAULT
55 | mov dword [ptab_pd + 8], (1 << 21) | PTE_DEFAULT | PTE_PS | PTE_G
56 |
57 | ; Load 64-bit GDT
58 | lgdt [_gdtp]
59 |
60 | ; Load page table
61 | mov eax, ptab_pml4
62 | mov cr3, eax
63 |
64 | ; Long mode initialization. See Intel SDM Vol. 3 Chapter 9.8.5.
65 | mov eax, CR4_PAE | CR4_PGE
66 | mov cr4, eax
67 |
68 | xor edx, edx
69 | mov eax, IA32_EFER_LME | IA32_EFER_NXE | IA32_EFER_SCE
70 | mov ecx, IA32_EFER
71 | wrmsr
72 |
73 | ; Enable paging and thus Long Mode.
74 | mov eax, cr0
75 | or eax, CR0_PG
76 | mov cr0, eax
77 |
78 | jmp RING0_CODE_SELECTOR:_start_long
79 |
80 | section .text.longinit
81 | bits 64
82 | _start_long:
83 |
84 | mov eax, RING0_DATA_SELECTOR
85 | mov ss, eax
86 | mov ds, eax
87 | mov es, eax
88 | mov fs, eax
89 | mov gs, eax
90 |
91 | lea rsp, [rel kern_stack_end]
92 |
93 | mov rbx, _init_array_start
94 | mov rbp, _init_array_end
95 |
96 | next_constructor:
97 | cmp rbx, rbp
98 | je done_with_contructors
99 | call [rbx]
100 | lea rbx, [rbx + 8]
101 | jmp next_constructor
102 |
103 | done_with_contructors:
104 | call main
105 | ud2
106 |
107 | section .bss
108 | global kern_stack_end
109 | align PAGE_SIZE
110 | kern_stack:
111 | resb PAGE_SIZE
112 | kern_stack_end:
113 |
114 | ptab_pml4:
115 | resb PAGE_SIZE
116 | ptab_pdpt:
117 | resb PAGE_SIZE
118 | ptab_pd:
119 | resb PAGE_SIZE
120 |
--------------------------------------------------------------------------------
/src/types.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | using uint8_t = unsigned char;
4 | using uint16_t = unsigned short;
5 | using uint32_t = unsigned;
6 | using uint64_t = unsigned long long;
7 |
8 | #ifdef __x86_64__
9 | using size_t = unsigned long;
10 | #elif defined(__i386__)
11 | using size_t = unsigned int;
12 | #else
13 | # error Unknown platform
14 | #endif
15 |
16 | using uintptr_t = unsigned long;
17 |
18 | #define __packed __attribute__((packed))
19 |
20 | inline bool likely(bool b) { return __builtin_expect(b, 1); }
21 | inline bool unlikely(bool b) { return __builtin_expect(b, 0); }
22 |
23 | template
24 | constexpr size_t array_size(T(&)[SIZE]) { return SIZE; }
25 |
26 | #define offsetof(type, member) __builtin_offsetof (type, member)
27 |
28 | inline void *operator new(size_t, void *p) { return p; }
29 |
--------------------------------------------------------------------------------
/src/x86-instructions.hpp:
--------------------------------------------------------------------------------
1 | #pragma once
2 |
3 | #include "types.hpp"
4 |
5 | // Wait forever.
6 | [[noreturn]] inline void cli_hlt()
7 | {
8 | while (true)
9 | asm volatile ("cli ; hlt");
10 | }
11 |
12 | // Immediate 8-bit OUT operation
13 | template
14 | inline void outbi(uint8_t data)
15 | {
16 | static_assert(PORT >= 0 and PORT < 0x100, "Port is out of range");
17 | asm volatile ("outb %%al, %0" :: "N" (PORT), "a" (data));
18 | }
19 |
20 | inline void outl(uint16_t port, uint32_t value)
21 | {
22 | asm volatile ("outl %0, %1" :: "a" (value), "d" (port));
23 | }
24 |
25 | inline uint32_t inl(uint16_t port)
26 | {
27 | uint32_t v;
28 | asm volatile ("inl %1, %0" : "=a" (v) : "d" (port));
29 | return v;
30 | }
31 |
32 | inline uint64_t get_cr2()
33 | {
34 | uint64_t v;
35 | asm volatile ("mov %%cr2, %0" : "=r" (v));
36 | return v;
37 | }
38 |
39 | inline void wrmsr(uint32_t sel, uint64_t val)
40 | {
41 | asm volatile ("wrmsr"
42 | :
43 | : "c" (sel),
44 | "a" ((uint32_t)val),
45 | "d" ((uint32_t)(val >> 32)));
46 | }
47 |
48 | inline uint64_t rdmsr(uint32_t sel)
49 | {
50 | uint32_t lo, hi;
51 | asm volatile ("rdmsr" : "=d" (hi), "=a" (lo) : "c" (sel));
52 | return (uint64_t)hi << 32 | lo;
53 | }
54 |
55 | inline uint64_t rdtsc()
56 | {
57 | uint32_t lo, hi;
58 | asm volatile ("rdtsc" : "=d" (hi), "=a" (lo));
59 | return (uint64_t)hi << 32 | lo;
60 | }
61 |
62 | inline void pause()
63 | {
64 | asm volatile ("pause");
65 | }
66 |
67 | // FPU handling
68 |
69 | enum : uint64_t {
70 | XCR0_FPU = 1UL << 0,
71 | XCR0_SSE = 1UL << 1,
72 | XCR0_AVX = 1UL << 2,
73 | };
74 |
75 | inline void set_xcr0(uint64_t v)
76 | {
77 | asm volatile ("xsetbv" :: "d" ((uint32_t)(v >> 32)), "a" ((uint32_t)v), "c" (0));
78 | }
79 |
80 | inline uint64_t get_xcr0()
81 | {
82 | uint32_t lo, hi;
83 | asm volatile ("xgetbv" : "=d" (hi), "=a" (lo) : "c" (0));
84 | return (uint64_t)hi << 32 | lo;
85 | }
86 |
87 | // CPUID
88 |
89 | struct cpuid_result {
90 | uint32_t eax;
91 | uint32_t ecx;
92 | uint32_t edx;
93 | uint32_t ebx;
94 | };
95 |
96 | inline cpuid_result query_cpuid(uint32_t eax, uint32_t ecx = 0)
97 | {
98 | cpuid_result res;
99 |
100 | asm ("cpuid"
101 | : "=a" (res.eax), "=c" (res.ecx), "=d" (res.edx), "=b" (res.ebx)
102 | : "a" (eax), "c" (ecx));
103 |
104 | return res;
105 | }
106 |
107 | inline bool is_vendor_intel(cpuid_result const &res)
108 | {
109 | return
110 | res.ebx == 0x756e6547 &&
111 | res.ecx == 0x6c65746e &&
112 | res.edx == 0x49656e69;
113 | }
114 |
115 | inline bool is_vendor_amd(cpuid_result const &res)
116 | {
117 | return
118 | res.ebx == 0x68747541 &&
119 | res.ecx == 0x444d4163 &&
120 | res.edx == 0x69746e65;
121 | }
122 |
--------------------------------------------------------------------------------