Skip to content
Snippets Groups Projects
Commit aeca949e authored by Anders Märak Leffler's avatar Anders Märak Leffler
Browse files

Instruction for manual patching instead of downloading everything.

parent 4c2a7c43
No related branches found
No related tags found
No related merge requests found
......@@ -16,9 +16,11 @@ Original code from course https://www.isy.liu.se/edu/kurs/TSEA81/ , licensed und
Clone this repo.
**Alternatively** Download the files from the course website. Replace `simple_os/src/si_comm.c` and `java-gui/java/SimpleOSComm.java` in your directory (as downloaded from the course web page). Then recompile.
## Compiling
Object files are included, but you might want to recompile anyway.
Object files are (now) included, but you might want to recompile anyway.
* Clean up the library files (useful: ```simple_os/make_lib_clean```).
* Make the library files again (useful: ```simple_os/make_lib_x86_host``` or the like.)
......@@ -32,7 +34,7 @@ proved helpful.
## Running
Set the environment variable ```SIMPLE_OS_PORT``` and make sure that
it is exported. Like so:
it is exported. Like so (bash syntax):
> export SIMPLE_OS_PORT=51224
......@@ -40,7 +42,7 @@ it is exported. Like so:
## Notes about usage
* Ports below 1024 are banned, since you shouldn't run this with system privileges (and this is required in those cases).
* Ports above 49152 should be ephemeral (https://en.wikipedia.org/wiki/List_of_TCP_and_UDP_port_numbers#cite_ref-345).
* Avoid ports that are already in use. A simple scheme might be to **pick port `5mmdd`** where MMDD is your month and day of birth. T
* Avoid ports that are already in use. A simple heuristic scheme (in the absence of random generators) might be to **start with port `5mmdd`** where MMDD is your month and day of birth.
* In general: don't scan for open ports automatically, even if you can. IT security will likely frown upon this.
* This should be a rather general solution, but compilation instructions for eg Windows is left to the interested user. Always refer back to the course!
* **If this opens a port on a non-firewalled computer reachable from the internet, and the software is vulnerable, it's probably a bad idea to run it. Regardless of which port you use.**
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment