guides: Add porting hack session #335
Open
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
mariasfiraiala
force-pushed
the
docs-porting
branch
3 times, most recently
from
c60370a
to
d414c2c
Compare
Signed-off-by: Maria Sfiraiala <maria.sfiraiala@gmail.com>
mariasfiraiala
force-pushed
the
docs-porting
branch
from
d414c2c
to
0a9f2c0
Compare
StefanJum
reviewed
Mar 2, 2024
| @@ -0,0 +1,693 @@ | |||
| --- | |||
| title: Porting On Unikraft | |||
There was a problem hiding this comment.
Suggested change
| title: Porting On Unikraft | |
| title: Advanced Porting On Unikraft |
| --- | ||
| title: Porting On Unikraft | ||
| description: | | ||
| We will talk about adapting certain components of Unikraft to your own advantage |
There was a problem hiding this comment.
Suggested change
| We will talk about adapting certain components of Unikraft to your own advantage | |
| We talk about adapting certain components of Unikraft to your own advantage. |
|
|
||
| ### Adding New Sections to an ELF | ||
|
|
||
| There are situations in which we want to add new sections in the executable file (ELF format - *Executable and Linking Format*) for our application or library. |
There was a problem hiding this comment.
Suggested change
| There are situations in which we want to add new sections in the executable file (ELF format - *Executable and Linking Format*) for our application or library. | |
| There are situations in which we want to add new sections in the executable file ([ELF format - *Executable and Linking Format*](https://en.wikipedia.org/wiki/Executable_and_Linkable_Format)) for our application or library. |
|
|
||
| The way we can add such a section in our application/library is the following: | ||
|
|
||
| 1. Create a file with the `.ld` extension (e.g. extra.ld) with the following content: |
There was a problem hiding this comment.
Suggested change
| 1. Create a file with the `.ld` extension (e.g. extra.ld) with the following content: | |
| 1. Create a file with the `.ld` extension (e.g. `extra.ld`) with the following content: |
|
|
||
| But enough with the chit-chat, let's get our hands dirty. | ||
| In the `/demo/01-extrald-app` directory there is an application that defines a new section in the ELF. | ||
| Copy this directory to your app's directory. |
There was a problem hiding this comment.
Suggested change
| Copy this directory to your app's directory. | |
| Setup the application dependencies in the usual layout. |
| You can start the program using the following command: | ||
|
|
||
| ```console | ||
| $ qemu-guest -k build/02-linked-list-app_kvm-x86_64 |
There was a problem hiding this comment.
Suggested change
| $ qemu-guest -k build/02-linked-list-app_kvm-x86_64 | |
| qemu-system-x86_64 -kernel workdir/build/02-linked-list-app_qemu-x86_64 -nographic |
|
|
||
| ### Support Files | ||
|
|
||
| Session support files are available [in the repository](https://github.com/unikraft/docs). |
There was a problem hiding this comment.
Suggested change
| Session support files are available [in the repository](https://github.com/unikraft/docs). | |
| Session support files are available [in the repository](https://github.com/unikraft-upb/guides-exercises). |
Comment on lines
+518
to
+519
| $ ls | ||
| demo/ images/ index.md/ sol/ work/ |
There was a problem hiding this comment.
Suggested change
| $ ls | |
| demo/ images/ index.md/ sol/ work/ | |
| $ ls advanced-porting/ | |
| demo sol work |
Comment on lines
+529
to
+532
| $ cd porting/ | ||
|
|
||
| $ ls | ||
| demo/ images/ index.md/ sol/ work/ |
There was a problem hiding this comment.
Suggested change
| $ cd porting/ | |
| $ ls | |
| demo/ images/ index.md/ sol/ work/ | |
| $ cd advanced-porting/ | |
| $ ls | |
| demo/ sol/ work/ |
|
|
||
| In this task we will add a new section in the elf and we will define a series of macros. | ||
|
|
||
| Navigate to the `01-extrald` directory. |
There was a problem hiding this comment.
Suggested change
| Navigate to the `01-extrald` directory. | |
| Navigate to the `work/01-extrald` directory. |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
No description provided.