@@ -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.**