juegos

chess-server.sh (4206B)

---

 #!/usr/bin/env bash
 # ^ Esta primera linea se llama "shebang". Le dice al sistema operativo con que
 #   programa tiene que ejecutar este archivo. En este caso, con "bash" (el
 #   interprete de comandos). Asi podemos correr el archivo directamente con
 #   ./bin/chess-server.sh en vez de tener que escribir "bash bin/chess-server.sh".
 #
 # ============================================================================
 #  bin/chess-server.sh  --  Servidor "relay" (repetidor) para jugar en red.
 # ============================================================================
 #
 # QUE ES ESTE ARCHIVO (para alguien que recien arranca):
 #   El ajedrez se puede jugar entre dos computadoras conectadas a la misma red
 #   local (por ejemplo, dos notebooks en la misma casa con el mismo WiFi).
 #   Hay dos formas de conectarlas:
 #     1) "peer to peer": una computadora hace de servidor y la otra se conecta
 #        directo a ella.
 #     2) con un "relay" (repetidor): una tercera computadora (o la misma) corre
 #        ESTE programa, y las dos jugadoras se conectan al relay. El relay no
 #        sabe nada de ajedrez: lo unico que hace es copiar cada mensaje que le
 #        manda una jugadora y reenviarselo a la otra. Como un cartero.
 #
 #   Toda la logica del ajedrez vive en las jugadoras (en ches.sh y lib/). El relay
 #   es "tonto" a proposito: solo mueve textos de un lado al otro.
 #
 # COMO SE USA:
 #   ./bin/chess-server.sh [puerto]      (si no pasas puerto, usa el 9000)
 #   y despues cada jugadora corre:  ./ches.sh server <ip-de-esta-maquina> <puerto>
 
 # --- Que puerto vamos a usar ------------------------------------------------
 # Un "puerto" es como el numero de un departamento dentro de un edificio (la
 # computadora es el edificio, identificado por su IP). Los programas de red
 # escuchan en un puerto para que otros sepan a donde golpear la puerta.
 #
 # "$1" es el PRIMER argumento que le pasamos al script en la linea de comandos.
 # La sintaxis "${1:-9000}" significa: "usa $1; pero si $1 esta vacio o no
 # existe, usa 9000 en su lugar". O sea, 9000 es el valor por defecto.
 PORT="${1:-9000}"
 
 # --- Chequear que tengamos la herramienta que necesitamos -------------------
 # "ncat" es un programita (viene en el paquete "nmap") que sabe abrir conexiones
 # de red. Lo usamos para el relay. Antes de seguir, verificamos que este
 # instalado.
 #
 # "command -v ncat" busca el programa ncat y, si lo encuentra, devuelve exito.
 # ">/dev/null" tira a la basura lo que imprima ese comando (no nos interesa ver
 # la ruta, solo queremos saber si existe). "/dev/null" es un "agujero negro":
 # todo lo que mandas ahi desaparece.
 #
 # El "||" quiere decir "O si lo anterior FALLO, entonces...". En bash, cada
 # comando devuelve un numero: 0 = salio todo bien, distinto de 0 = hubo error.
 # Entonces "comandoA || comandoB" ejecuta comandoB SOLO si comandoA fallo.
 #
 # Las llaves { ... } agrupan varios comandos para que se ejecuten juntos.
 # "echo ... >&2" imprime un mensaje de error: ">&2" lo manda a la "salida de
 # errores" (que es la forma correcta de mostrar errores, separados de la salida
 # normal). "exit 1" termina el programa devolviendo 1 (codigo de error).
 command -v ncat >/dev/null || { echo "ncat is required (install nmap)." >&2; exit 1; }
 
 # --- Avisarle a la persona que arranco bien ---------------------------------
 # "echo" simplemente imprime texto en la pantalla. Ojo: los mensajes que ve la
 # persona quedan en ingles a proposito (es la interfaz del juego).
 echo "Chess relay server listening on port ${PORT} (broker mode)."
 echo "Players connect with:  ./ches.sh server <server-ip> ${PORT}"
 echo "Press Ctrl-C to stop."
 
 # --- Arrancar el relay de verdad --------------------------------------------
 # "exec" reemplaza este script por el programa que le pasamos (ncat). Es decir,
 # a partir de aca el proceso DEJA de ser nuestro script y PASA a ser ncat. Lo
 # usamos porque no necesitamos hacer nada mas despues: que ncat se quede
 # corriendo para siempre haciendo de repetidor.
 #
 # Banderas de ncat:
 #   -l "$PORT"   "listen": quedate escuchando conexiones en este puerto.
 #   --broker     modo repetidor: reenvia a cada cliente lo que mandan los demas.
 exec ncat -l "$PORT" --broker