# Archivos, pipes y una shell mínima

Lab 4 · Filesystem · Sistemas Operativos
Page: https://alfonsocampodonico.com/classes/operating-systems/lab-shell?lang=es
Code: https://github.com/AlfonsoCampodonico/os-lab/tree/main/starter/lab4-tiny-shell (`gh repo clone AlfonsoCampodonico/os-lab`)

> ¿Cómo conectan las shells de Unix a los programas entre sí usando file descriptors y pipes?

## Pregunta guía

¿Cómo conectan las shells de Unix a los programas entre sí usando file descriptors y pipes?

## Conceptos

- file descriptors
- entrada y salida estándar
- redirección
- pipes
- creación de procesos y lanzamiento de comandos

## Escenario

Estás implementando una shell mínima para estudiantes que necesitan ver cómo se conectan
los comandos por debajo de la terminal. La shell tiene que correr comandos simples, soportar
redirección de salida y soportar un pipeline con un solo pipe.

Proyecto inicial: `starter/lab4-tiny-shell`

## Tareas de observación

Antes de modificar el código inicial:

1. Corré `printf 'echo hi | wc -c\n' | strace -f sh`
2. Corré `lsof -p <shell-pid>` sobre un proceso de shell real
3. Explicá qué pasa con los file descriptors durante la redirección

## Tareas de implementación

El código inicial ya trae una versión mínima de los ítems 1–4; leelo,
explicá cada parte y después extendelo para que soporte:

1. lanzar un comando externo simple
2. redirección de salida con `>`
3. un único pipeline `cmd1 | cmd2`
4. un mensaje de error útil cuando falla el parseo
5. una explicación de por qué hace falta `dup2()`

## Puntos de control

- ¿Qué conecta un pipe?
- ¿Por qué cada lado de un pipeline cierra descriptores distintos?
- ¿Por qué el file descriptor `1` es importante para la redirección?
- ¿Qué cambia entre el proceso de la shell padre y el proceso hijo del comando?

## Entregables

- `tinysh.zig` actualizado
- una transcripción con un comando simple, un comando redirigido y un pipeline
- respuestas a las preguntas de los puntos de control

## Objetivos extra

- agregar redirección de entrada con `<`
- agregar ejecución en segundo plano con `&`
- agregar un builtin `jobs`

## Verificación sugerida

```bash
zig build -p zig-out
printf 'help\nquit\n' | ./zig-out/bin/tinysh
printf 'echo hi | wc -c\nquit\n' | ./zig-out/bin/tinysh
printf 'echo hi > out.txt\nquit\n' | ./zig-out/bin/tinysh
```

## Criterios de corrección

- manejo correcto de los descriptores
- configuración correcta del proceso hijo
- explicación clara de cómo la shell usa las primitivas del sistema operativo


## Compilarlo

Con Zig **0.16.x** instalado (la 0.17 eliminó `@cImport`, que usan los starters), desde la raíz del repositorio:

```sh
zig build -p zig-out
bash scripts/smoke_test.sh
```
