Add readme and build.sh
This commit is contained in:
parent
af241224c9
commit
85ab947672
|
@ -0,0 +1,55 @@
|
|||
# BottlerOS
|
||||
|
||||
BottlerOS es un sistema operativo...
|
||||
|
||||
## Table de contenidos
|
||||
* [Requisitos](#requisitos)
|
||||
* [Compilación](#compilación)
|
||||
* [Ejecución](#ejecución)
|
||||
* [Testeos](#tests)
|
||||
|
||||
## Requisitos <a name="requisitos"></a>
|
||||
|
||||
Debe instalar nasm, qemu, gcc, make. Estos se encuentra disponibles en el repositorio de la vasta mayoría de distribuciones de Linux/macOS.
|
||||
|
||||
Debian/Ubuntu: `apt install nasm qemu gcc make`\
|
||||
macOS (con [homebrew](https://brew.sh/)): `brew install nasm qemu gcc make`
|
||||
|
||||
Si tiene otra distribución consulte cómo hacerlo.
|
||||
|
||||
## Compilación <a name="compilación"></a>
|
||||
|
||||
Para compilar todos los archivos se debe ejecutar el script `build.sh` (desde la carpeta raíz del proyecto). Note que usted podrá pasarle como argumento `buddy` si desea compilar con este memory manager (por defecto no compilará con este).
|
||||
|
||||
```bash
|
||||
./build.sh
|
||||
```
|
||||
|
||||
## Ejecución <a name="ejecución"></a>
|
||||
|
||||
Ahora, usted podrá ejecutar BottlerOS haciendo:
|
||||
|
||||
```bash
|
||||
./run.sh
|
||||
```
|
||||
|
||||
Si, en su defecto, usted quiere correr el OS desde windows lo podrá hacer con:
|
||||
|
||||
```bash
|
||||
./run.bat
|
||||
```
|
||||
|
||||
## Testeos <a name="tests"></a>
|
||||
|
||||
En orden de realizar un análisis estático del sistema usted debe tener instalado [cppcheck](http://cppcheck.net/) y [pvs-studio](https://pvs-studio.com/). Luego, puede correrlos con:
|
||||
|
||||
```bash
|
||||
make test
|
||||
```
|
||||
|
||||
Por último, si quiere hacer un análisis dinámico (usando [valgrind](https://valgrind.org/)) debe ejecutar ...
|
||||
|
||||
# Autores
|
||||
- Barmasch, Juan Martín (61033)
|
||||
- Bellver, Ezequiel (61268)
|
||||
- Lo Coco, Santiago (61301)
|
|
@ -0,0 +1,24 @@
|
|||
#!/bin/sh
|
||||
|
||||
if ! ls | grep -q "build.sh"; then
|
||||
echo "You must be in the root folder of the project"
|
||||
exit 1
|
||||
fi
|
||||
|
||||
cd Toolchain
|
||||
make all
|
||||
cd ..
|
||||
|
||||
if [ $# -eq 1 ]; then
|
||||
if [ $1 = "buddy" ]; then
|
||||
make buddy
|
||||
else
|
||||
echo "Do you want to compile with the buddy memory manager? if so, you must pass buddy as argument"
|
||||
fi
|
||||
elif [ $# -eq 0 ]; then
|
||||
make all
|
||||
else
|
||||
echo "You can only enter one parameter or none"
|
||||
fi
|
||||
|
||||
|
Loading…
Reference in New Issue