| @@ -1,5 +1,22 @@ | |||||
| # Changelog | # Changelog | ||||
| ## 1.0.5 — 2026-09-21 — Production SMF activation contract | |||||
| - Retirado `--force-dry-run` del método start del manifiesto SMF versionado para | |||||
| que `ACTION_MODE` sea la fuente única de la política de acción. | |||||
| - Conservado `ACTION_MODE dry-run` en la configuración distribuida: una | |||||
| instalación nueva continúa siendo segura por defecto. | |||||
| - Conservada la opción CLI `--force-dry-run` para probe, pruebas y validaciones | |||||
| manuales. | |||||
| - Neutralizado el `common_name` del servicio a `o6h memory pressure guard`. | |||||
| - Documentados activación explícita, upgrade desde manifiestos v1.0.4 o | |||||
| anteriores, verificación del repositorio SMF/proceso y rollback. | |||||
| - Añadida advertencia de no reiniciar cerca de `lotsfree`, porque cada restart | |||||
| reinicia la inhibición `armed_warmup=60`. | |||||
| - Añadida una prueba del contrato de distribución para impedir regresiones del | |||||
| exec SMF, modo inicial y parámetros operativos 1/2/2/15, 5/1/0/15 y 4/4/8/12. | |||||
| - No hubo despliegue, activación de armed ni señales reales. | |||||
| ## 1.0.4 — 2026-09-21 — Global victim ranking fix | ## 1.0.4 — 2026-09-21 — Global victim ranking fix | ||||
| - Sustituido el orden lexicográfico dominado por `zone_score` por un top‑3 | - Sustituido el orden lexicográfico dominado por `zone_score` por un top‑3 | ||||
| @@ -6,7 +6,7 @@ LDLIBS = -lkstat -lrt | |||||
| SOURCES = src/main.c src/core.c src/config.c src/support.c src/illumos.c | SOURCES = src/main.c src/core.c src/config.c src/support.c src/illumos.c | ||||
| TESTFLAGS = -std=c99 -O1 -g -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700 -Isrc -Wall -Wextra -Werror -Wformat=2 -pedantic | TESTFLAGS = -std=c99 -O1 -g -D_POSIX_C_SOURCE=200809L -D_XOPEN_SOURCE=700 -Isrc -Wall -Wextra -Werror -Wformat=2 -pedantic | ||||
| .PHONY: all native-check test test-sanitize portability clean | |||||
| .PHONY: all native-check test test-distribution test-sanitize portability clean | |||||
| all: o6h-memory-guard | all: o6h-memory-guard | ||||
| native-check: | native-check: | ||||
| @@ -21,7 +21,10 @@ test-guard: tests/test_guard.c tests/fixtures/pageout_deadman_real_incident_2026 | |||||
| test-runtime: tests/test_runtime.c tests/fixtures/global_victim_ranking_smartos_2026_09.csv src/main.c src/core.c src/config.c src/guard.h | test-runtime: tests/test_runtime.c tests/fixtures/global_victim_ranking_smartos_2026_09.csv src/main.c src/core.c src/config.c src/guard.h | ||||
| $(CC) $(TESTFLAGS) -o $@ tests/test_runtime.c src/core.c src/config.c | $(CC) $(TESTFLAGS) -o $@ tests/test_runtime.c src/core.c src/config.c | ||||
| test: test-guard test-runtime | |||||
| test-distribution: tests/test_distribution.sh smf/o6h-memory-guard.xml etc/o6h-memory-guard.conf src/main.c | |||||
| sh tests/test_distribution.sh | |||||
| test: test-guard test-runtime test-distribution | |||||
| ./test-guard | ./test-guard | ||||
| ./test-runtime | ./test-runtime | ||||
| @@ -35,7 +38,7 @@ test-sanitize: | |||||
| portability: | portability: | ||||
| $(CC) $(TESTFLAGS) -Itests/api-sketch -fsyntax-only $(SOURCES) | $(CC) $(TESTFLAGS) -Itests/api-sketch -fsyntax-only $(SOURCES) | ||||
| @for source in $(SOURCES); do $(CC) $(TESTFLAGS) -Itests/api-sketch -fanalyzer -c $$source -o /dev/null || exit 1; done | @for source in $(SOURCES); do $(CC) $(TESTFLAGS) -Itests/api-sketch -fanalyzer -c $$source -o /dev/null || exit 1; done | ||||
| sh -n install.sh | |||||
| sh -n install.sh tests/test_distribution.sh | |||||
| xmllint --nonet --noout smf/o6h-memory-guard.xml | xmllint --nonet --noout smf/o6h-memory-guard.xml | ||||
| clean: | clean: | ||||
| @@ -1,13 +1,26 @@ | |||||
| # o6h-memory-guard 1.0.4 | |||||
| # o6h-memory-guard 1.0.5 | |||||
| Primera implementación para SmartOS global zone: daemon C de 64 bits, libkstat, | Primera implementación para SmartOS global zone: daemon C de 64 bits, libkstat, | ||||
| /proc, identidad UUID + generación de zona + PID + instante de creación, | /proc, identidad UUID + generación de zona + PID + instante de creación, | ||||
| configuración separada y servicio SMF. Entrega de código fuente; **no contiene | configuración separada y servicio SMF. Entrega de código fuente; **no contiene | ||||
| un binario nativo validado en SmartOS**. Véase `VALIDATION.md`. | un binario nativo validado en SmartOS**. Véase `VALIDATION.md`. | ||||
| Arranca en `dry-run`. El manifiesto añade `--force-dry-run`, por lo que cambiar | |||||
| sólo `ACTION_MODE` no arma el servicio. No se entrega ninguna zona autorizada. | |||||
| No se ha desplegado ni se han enviado señales reales durante la preparación. | |||||
| Una instalación nueva arranca en `dry-run` porque la configuración distribuida | |||||
| contiene `ACTION_MODE dry-run`. El manifiesto SMF de producción no fuerza ese | |||||
| modo: la configuración es la única fuente de la política de acción. No se | |||||
| entrega ninguna zona autorizada. Esta revisión no se ha desplegado, no ha | |||||
| activado `armed` y no ha enviado señales reales. | |||||
| ```text | |||||
| Instalación nueva | |||||
| → ACTION_MODE dry-run | |||||
| → SMF no fuerza dry-run | |||||
| Activación real | |||||
| → el operador cambia explícitamente ACTION_MODE armed | |||||
| → reinicia SMF | |||||
| → armed_warmup=60 sigue aplicando | |||||
| ``` | |||||
| ## Documentación de la entrega | ## Documentación de la entrega | ||||
| @@ -32,12 +45,12 @@ Si no hay herramientas de desarrollo, compilar en una **zona nativa SmartOS** | |||||
| de la misma plataforma (no LX), ejecutar allí `gmake test`, y copiar el binario | de la misma plataforma (no LX), ejecutar allí `gmake test`, y copiar el binario | ||||
| junto a este árbol al host. No instalar un compilador en un nodo bajo presión. | junto a este árbol al host. No instalar un compilador en un nodo bajo presión. | ||||
| Copiar el archivo distribuido a `/var/tmp/o6h-memory-guard-1.0.4.tar.gz`: | |||||
| Copiar el archivo distribuido a `/var/tmp/o6h-memory-guard-1.0.5.tar.gz`: | |||||
| ```sh | ```sh | ||||
| mkdir -p /opt/custom/src | mkdir -p /opt/custom/src | ||||
| cd /opt/custom/src | cd /opt/custom/src | ||||
| gzip -dc /var/tmp/o6h-memory-guard-1.0.4.tar.gz | tar -xf - | |||||
| gzip -dc /var/tmp/o6h-memory-guard-1.0.5.tar.gz | tar -xf - | |||||
| cd /opt/custom/src/o6h-memory-guard | cd /opt/custom/src/o6h-memory-guard | ||||
| gmake CC=gcc | gmake CC=gcc | ||||
| gmake test CC=gcc | gmake test CC=gcc | ||||
| @@ -84,8 +97,8 @@ svcprop -p start/exec svc:/site/o6h-memory-guard:default | |||||
| tail -f /opt/custom/var/log/o6h-memory-guard/guard.log | tail -f /opt/custom/var/log/o6h-memory-guard/guard.log | ||||
| ``` | ``` | ||||
| Verificar `mode=dry-run` en `event=start`, `--force-dry-run` en `start/exec`, | |||||
| `arc_ok=1`, `swap_committed_ok=1`, `swap_physical_used_ok=1`, | |||||
| Verificar `mode=dry-run` en `event=start`, ausencia de `--force-dry-run` en | |||||
| `start/exec`, `arc_ok=1`, `swap_committed_ok=1`, `swap_physical_used_ok=1`, | |||||
| `anon_pageout_ok=1` y | `anon_pageout_ok=1` y | ||||
| `proc_scan complete=1`. No generar presión artificial | `proc_scan complete=1`. No generar presión artificial | ||||
| en producción. Para comprobar selección y UUID, revisar `candidate`, `zone` y | en producción. Para comprobar selección y UUID, revisar `candidate`, `zone` y | ||||
| @@ -103,9 +116,11 @@ svccfg validate /opt/custom/smf/o6h-memory-guard.xml | |||||
| svccfg import /opt/custom/smf/o6h-memory-guard.xml | svccfg import /opt/custom/smf/o6h-memory-guard.xml | ||||
| ``` | ``` | ||||
| Mantener `--force-dry-run`. La ubicación `/opt/custom/smf` se utiliza para | |||||
| servicios personalizados persistentes de SmartOS; no depender exclusivamente | |||||
| del estado habilitado de la instancia en el repositorio del arranque actual. | |||||
| Mantener `ACTION_MODE dry-run` durante toda la validación inicial. La ubicación | |||||
| `/opt/custom/smf` se utiliza para servicios personalizados persistentes de | |||||
| SmartOS; no depender exclusivamente del estado habilitado de la instancia en el | |||||
| repositorio del arranque actual. `--force-dry-run` sigue disponible para | |||||
| `--probe`, pruebas y validaciones manuales, pero no pertenece al método SMF. | |||||
| ## Métricas y ventanas | ## Métricas y ventanas | ||||
| @@ -327,19 +342,26 @@ Los eventos `state_transition`, `candidate_cache`, `action_decision` y | |||||
| `recovery_check` permiten reconstruir el estado, origen/rank/edad del candidato, | `recovery_check` permiten reconstruir el estado, origen/rank/edad del candidato, | ||||
| resultado del último scan, componentes del score y cualquier override de presupuesto. | resultado del último scan, componentes del score y cualquier override de presupuesto. | ||||
| ## Preparación de armed (NO GO para v1.0.4 inicial) | |||||
| ## Modelo de activación real (operación futura; no ejecutada en esta entrega) | |||||
| v1.0.4 debe compilarse y observarse primero en SmartOS exclusivamente en | |||||
| `dry-run`; el incidente real aún no autoriza señales. En una fase futura se | |||||
| necesitarían deliberadamente dos cambios: `ACTION_MODE armed` en la config y | |||||
| retirar `--force-dry-run` del método start del manifiesto. Mantener las reglas | |||||
| UUID `allow` mínimas y verificar antes las protecciones y el laboratorio nativo. | |||||
| Después de esos cambios, validar config/manifiesto, importar, refrescar y | |||||
| reiniciar el servicio. Verificar `event=start mode=armed`; comienza la inhibición | |||||
| de 60 s. No se proporciona un script que arme automáticamente el servicio. | |||||
| v1.0.5 debe compilarse y observarse primero en SmartOS con `ACTION_MODE dry-run`. | |||||
| El manifiesto ya no contiene una segunda puerta oculta. Cuando exista aprobación | |||||
| operativa explícita, el único cambio de modo es editar la configuración: | |||||
| Para volver a dry-run, restaurar `ACTION_MODE dry-run` y `--force-dry-run` en | |||||
| el manifiesto; importar, `svcadm refresh` y `svcadm restart` la instancia. | |||||
| ```sh | |||||
| vi /opt/custom/etc/o6h-memory-guard.conf | |||||
| # cambiar exactamente: ACTION_MODE dry-run → ACTION_MODE armed | |||||
| /opt/custom/bin/o6h-memory-guard --check-config | |||||
| svcadm restart svc:/site/o6h-memory-guard:default | |||||
| ``` | |||||
| Mantener las reglas UUID `allow` mínimas y verificar antes las protecciones y el | |||||
| laboratorio nativo. Tras el restart, comprobar `event=start mode=armed`; durante | |||||
| los primeros 60 s `armed_warmup` inhibe señales, aunque la detección y la caché | |||||
| siguen activas. No se proporciona un script que arme automáticamente el servicio. | |||||
| Para volver a dry-run, restaurar `ACTION_MODE dry-run`, validar la configuración | |||||
| y reiniciar SMF. No es necesario editar el manifiesto. | |||||
| ## Parada, rollback y actualización | ## Parada, rollback y actualización | ||||
| @@ -377,7 +399,66 @@ niega a sobrescribir por ese motivo. | |||||
| La migración desde v1.0.3 a v1.0.4 no añade parámetros de configuración: cambia | La migración desde v1.0.3 a v1.0.4 no añade parámetros de configuración: cambia | ||||
| el algoritmo de ranking y su logging. Comparar el top‑3 global en SmartOS real | el algoritmo de ranking y su logging. Comparar el top‑3 global en SmartOS real | ||||
| antes de reemplazar el binario observado y mantener siempre `--force-dry-run`. | |||||
| antes de reemplazar el binario observado. | |||||
| ### Upgrade del manifiesto desde v1.0.4 o anterior | |||||
| Los manifiestos antiguos incluían `--force-dry-run`. Antes de retirarlo, | |||||
| comprobar el modo configurado. Si no se pretende activar señales en ese mismo | |||||
| restart, debe decir literalmente `ACTION_MODE dry-run`: | |||||
| ```sh | |||||
| grep '^ACTION_MODE ' /opt/custom/etc/o6h-memory-guard.conf | |||||
| /opt/custom/bin/o6h-memory-guard --check-config --force-dry-run | |||||
| kstat -p unix:0:system_pages:freemem unix:0:system_pages:lotsfree | |||||
| ``` | |||||
| No hacer un restart innecesario cuando `freemem` esté cerca o por debajo de | |||||
| `lotsfree`: cada arranque reinicia `armed_warmup=60` y, si el modo fuese armed, | |||||
| dejaría las señales inhibidas durante 60 s precisamente cuando podrían ser | |||||
| necesarias. Posponer el cambio hasta que el nodo esté estable. | |||||
| Con memoria estable, conservar el manifiesto anterior y copiar el nuevo: | |||||
| ```sh | |||||
| mkdir -p /opt/custom/var/backups/o6h-memory-guard | |||||
| cp -p /opt/custom/smf/o6h-memory-guard.xml \ | |||||
| /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run | |||||
| cp /opt/custom/src/o6h-memory-guard/smf/o6h-memory-guard.xml \ | |||||
| /opt/custom/smf/o6h-memory-guard.xml | |||||
| svccfg validate /opt/custom/smf/o6h-memory-guard.xml | |||||
| svccfg import /opt/custom/smf/o6h-memory-guard.xml | |||||
| svcadm restart svc:/site/o6h-memory-guard:default | |||||
| ``` | |||||
| Comprobar tanto la definición importada como el proceso activo: | |||||
| ```sh | |||||
| svccfg export svc:/site/o6h-memory-guard:default | | |||||
| grep -A3 -B2 'o6h-memory-guard --daemon' | |||||
| pgrep -fl o6h-memory-guard | |||||
| ``` | |||||
| Ambas salidas deben quedar sin `--force-dry-run`. Con la configuración | |||||
| distribuida, `event=start` debe seguir mostrando `mode=dry-run`. | |||||
| ### Rollback del manifiesto anterior | |||||
| Primero asegurar `ACTION_MODE dry-run` y comprobar de nuevo que la memoria está | |||||
| holgada respecto a `lotsfree`. Después restaurar la copia y reimportarla: | |||||
| ```sh | |||||
| cp /opt/custom/var/backups/o6h-memory-guard/o6h-memory-guard.xml.v1.0.4-forced-dry-run \ | |||||
| /opt/custom/smf/o6h-memory-guard.xml | |||||
| svccfg validate /opt/custom/smf/o6h-memory-guard.xml | |||||
| svccfg import /opt/custom/smf/o6h-memory-guard.xml | |||||
| svcadm restart svc:/site/o6h-memory-guard:default | |||||
| ``` | |||||
| El rollback vuelve a añadir la puerta forzada del manifiesto antiguo. Registrar | |||||
| qué versión queda instalada para no confundir ese comportamiento con la política | |||||
| de configuración de v1.0.5. | |||||
| ## Referencias revisadas | ## Referencias revisadas | ||||
| @@ -1,21 +1,22 @@ | |||||
| 887569535302f7deba4d7c6ffb2103f1fb90bd96a40280240ff238eddc2e3a6f ./.gitignore | 887569535302f7deba4d7c6ffb2103f1fb90bd96a40280240ff238eddc2e3a6f ./.gitignore | ||||
| 2e27e56dea5e00b74ccdd2ae2d5d8ff7ca7f01d82c1d2ed27ea976a7bf382856 ./CHANGELOG.md | |||||
| e45fac9145e5cdd63490c3e4b9c8f6eb34894b05c90ef1af6ca8886cb7cee741 ./CHANGELOG.md | |||||
| ebfca7d4b5eaf0c0cc9910cf49d8c85f6aa7ff69972d7f21d17e61d1a2e23bc2 ./CHECKPOINT.md | ebfca7d4b5eaf0c0cc9910cf49d8c85f6aa7ff69972d7f21d17e61d1a2e23bc2 ./CHECKPOINT.md | ||||
| a0f96300e751d08ceeef1360325ed54008b703fa6bd07df9d5368674e580f113 ./INCIDENT_PAGEOUT_DEADMAN_2026_09.md | a0f96300e751d08ceeef1360325ed54008b703fa6bd07df9d5368674e580f113 ./INCIDENT_PAGEOUT_DEADMAN_2026_09.md | ||||
| df619be1585cd8d6173acba541fcaeeb1e94e55459dc059914863d0e9f316121 ./Makefile | |||||
| 9a841ab6077f10267ee73f23b51be849d391fd0deddee85bf99338601b3b379e ./README.md | |||||
| c749b5a31b3a9a72de4e2c4bb8903ccc901ddde7aa702ccbebcbfd57c075dcef ./VALIDATION.md | |||||
| f89457e6fd793911c8e73843ce7f38fe0c119045c66c06fca1cb962737c8c45d ./etc/o6h-memory-guard.conf | |||||
| 7e735ae0ca694e748b0051a47873b53424d8d934f735f8d055ccba186de08a80 ./Makefile | |||||
| 6894f18fd377502ada7b9b51ec846f6d6ffe263531c457a81a50366b7d27fc3b ./README.md | |||||
| fa95db79696c6a1526d3ed94277911bcd9157b9bff74f9e5a997e4ab02fd669c ./VALIDATION.md | |||||
| a4727d5ac7d5ba06f59dd1ae459fcb12e1d0d966e823bec1ed9409077d986ae7 ./etc/o6h-memory-guard.conf | |||||
| f6565d0e1ece0a08721c9893f9ed071d2ab0a2818fa93ed0a14e0050d358ce99 ./install.sh | f6565d0e1ece0a08721c9893f9ed071d2ab0a2818fa93ed0a14e0050d358ce99 ./install.sh | ||||
| b9b5b28aff2d34dd8d544a73a2c4a14b8e622185b68751dd0227671c298cd50a ./logs/example.log | |||||
| 24c1b9bc39fda71d459d6fad6a8d889b0d9b92be89d303677643b3d0b93caf4b ./logs/distribution-tests.log | |||||
| 50626dec1924e19b4ca92eec30416fb39c3fe7cff28d98a8e120ccf6247d2834 ./logs/example.log | |||||
| b7d6826f353765641a95025344c30e6f5eb228772f29e04399a9ec78e3fb5595 ./logs/policy-tests.log | b7d6826f353765641a95025344c30e6f5eb228772f29e04399a9ec78e3fb5595 ./logs/policy-tests.log | ||||
| abafc237427b63f38f81d0d1b76ba64eefc64d9f8074fdaa6ed0f1573b5d0a3b ./logs/portability.log | |||||
| 08a771544b1e8f29eefc07477af6b83f71ab4824192edd32567e1a9182631bfa ./logs/portability.log | |||||
| ed9246c2a7a82ed42a49dc72439cd452f2ab8a76b4dcd1aaf466ba23eb75fc5c ./logs/runtime-tests.log | ed9246c2a7a82ed42a49dc72439cd452f2ab8a76b4dcd1aaf466ba23eb75fc5c ./logs/runtime-tests.log | ||||
| 2632e52bc306f5ccc947aac41d91f0b7ad54043a4192a0c4d7ed69616b1183c5 ./logs/sanitizers.log | 2632e52bc306f5ccc947aac41d91f0b7ad54043a4192a0c4d7ed69616b1183c5 ./logs/sanitizers.log | ||||
| b55afd45a72947efdda79d593255c36def9679bcb7a33ab14d55170ebaf9bef7 ./smf/o6h-memory-guard.xml | |||||
| 55cf49840cf1d22e4e02bedf579a10207856a0a5b40c86ae2cf6ee2f00d3f972 ./smf/o6h-memory-guard.xml | |||||
| 9a4468d9acc3f1da078b009f764c7cb7bf337682d6584b8cbaf7b540c520d5f5 ./src/config.c | 9a4468d9acc3f1da078b009f764c7cb7bf337682d6584b8cbaf7b540c520d5f5 ./src/config.c | ||||
| c1f81909ec63fdb85948bbe58642478a80105b26a7c64eaf463c0e6fc42de203 ./src/core.c | c1f81909ec63fdb85948bbe58642478a80105b26a7c64eaf463c0e6fc42de203 ./src/core.c | ||||
| df4baeefd240a61916fcdd4a06167fa34621510db027eb20cce0b3559c37b28c ./src/guard.h | |||||
| 4d8d30d2903d9da67c25f73cc58179bb5dfd297d3697df1fa1fe3aee47071f95 ./src/guard.h | |||||
| 32ab75bb6a1ff2bbbeb6a1ea658abcb96a03fcc06246f38d019faec7fdc184b8 ./src/illumos.c | 32ab75bb6a1ff2bbbeb6a1ea658abcb96a03fcc06246f38d019faec7fdc184b8 ./src/illumos.c | ||||
| 4b643eb55f7846c5b1ae5906a13dec3f7ac9b6191778c8352cffd39ca0bf2bfd ./src/main.c | 4b643eb55f7846c5b1ae5906a13dec3f7ac9b6191778c8352cffd39ca0bf2bfd ./src/main.c | ||||
| 2cb2b4c50fd42051fde4a702e8955e07d63979d5e3216e02420ed9b54fb67578 ./src/support.c | 2cb2b4c50fd42051fde4a702e8955e07d63979d5e3216e02420ed9b54fb67578 ./src/support.c | ||||
| @@ -26,5 +27,6 @@ f0d06353d2e326c7bdce776bee6f0a8606cda50d5de957dfdd586b6848fca8da ./tests/api-sk | |||||
| 9b99e272008ad00ad0abb366e1e8720dd6c51fc050821c5d1d878eae5719c22b ./tests/api-sketch/zone.h | 9b99e272008ad00ad0abb366e1e8720dd6c51fc050821c5d1d878eae5719c22b ./tests/api-sketch/zone.h | ||||
| 4aa08ded8e98cf25d2a8762543de7a9273f0ebf00b4c7e5b359603ceda46eb56 ./tests/fixtures/global_victim_ranking_smartos_2026_09.csv | 4aa08ded8e98cf25d2a8762543de7a9273f0ebf00b4c7e5b359603ceda46eb56 ./tests/fixtures/global_victim_ranking_smartos_2026_09.csv | ||||
| c5d9d7fc7a39354474d30cd316ea9f122205c2b38e57f927f4a08306b8a62c81 ./tests/fixtures/pageout_deadman_real_incident_2026_09.csv | c5d9d7fc7a39354474d30cd316ea9f122205c2b38e57f927f4a08306b8a62c81 ./tests/fixtures/pageout_deadman_real_incident_2026_09.csv | ||||
| 5e80231bf4e9d04e9fbfc5f78b05c561925614346e5876986e1701a1b76efaa3 ./tests/test_distribution.sh | |||||
| b7ac53f6b26b4e7e2e19d7258b570a64462182ffe85c93374856caf77ec0c871 ./tests/test_guard.c | b7ac53f6b26b4e7e2e19d7258b570a64462182ffe85c93374856caf77ec0c871 ./tests/test_guard.c | ||||
| 76c0a6d64a3feb74678f0455ad32a4392cea169aee735035f65b17837b82a931 ./tests/test_runtime.c | 76c0a6d64a3feb74678f0455ad32a4392cea169aee735035f65b17837b82a931 ./tests/test_runtime.c | ||||
| @@ -1,16 +1,17 @@ | |||||
| # Validación de la entrega v1.0.4 | |||||
| # Validación de la entrega v1.0.5 | |||||
| Fecha: 2026-09-21. v1.0.3 se desplegó y se está validando en SmartOS real sólo | Fecha: 2026-09-21. v1.0.3 se desplegó y se está validando en SmartOS real sólo | ||||
| en `dry-run`; confirmó la telemetría, SMF, scans y caché persistente, pero reveló | en `dry-run`; confirmó la telemetría, SMF, scans y caché persistente, pero reveló | ||||
| que `zone_score` podía monopolizar el top‑3. **v1.0.4 no se ha desplegado, no ha | |||||
| activado `armed` y no ha enviado señales reales.** El manifiesto mantiene | |||||
| `--force-dry-run`, la configuración mantiene `ACTION_MODE dry-run`, la instancia | |||||
| SMF viene deshabilitada y no se distribuye ningún UUID `allow`. | |||||
| que `zone_score` podía monopolizar el top‑3. **v1.0.5 no se ha desplegado, no ha | |||||
| activado `armed` y no ha enviado señales reales.** El manifiesto de producción | |||||
| ya no fuerza `--force-dry-run`; la configuración distribuida mantiene | |||||
| `ACTION_MODE dry-run`, la instancia SMF viene deshabilitada y no se distribuye | |||||
| ningún UUID `allow`. | |||||
| `CHECKPOINT.md` conserva la validación operativa previa de v1.0.2. | `CHECKPOINT.md` conserva la validación operativa previa de v1.0.2. | ||||
| `INCIDENT_PAGEOUT_DEADMAN_2026_09.md` documenta el incidente, el endurecimiento | `INCIDENT_PAGEOUT_DEADMAN_2026_09.md` documenta el incidente, el endurecimiento | ||||
| v1.0.3 y el hallazgo que motiva v1.0.4. La telemetría nativa ya validada no se ha | |||||
| refactorizado. | |||||
| v1.0.3 y el hallazgo que motivó v1.0.4. v1.0.5 sólo cambia el contrato de | |||||
| activación SMF y su documentación; la telemetría nativa no se ha refactorizado. | |||||
| ## Evidencia real que motiva esta revisión | ## Evidencia real que motiva esta revisión | ||||
| @@ -28,9 +29,12 @@ aproximadamente 1,33 GiB en cuatro zonas menores. El fixture | |||||
| `tests/fixtures/global_victim_ranking_smartos_2026_09.csv` conserva esas | `tests/fixtures/global_victim_ranking_smartos_2026_09.csv` conserva esas | ||||
| proporciones y procesos `mysqld` protegidos. | proporciones y procesos `mysqld` protegidos. | ||||
| ## Comprobaciones automatizadas de v1.0.4 | |||||
| ## Comprobaciones automatizadas de v1.0.5 | |||||
| - `make test` completa 138 comprobaciones de política y 138 de runtime. | - `make test` completa 138 comprobaciones de política y 138 de runtime. | ||||
| - La prueba de distribución exige `ACTION_MODE dry-run`, los doce parámetros | |||||
| operativos 1/2/2/15, 5/1/0/15 y 4/4/8/12, el exec SMF sin | |||||
| `--force-dry-run`, el `common_name` neutral y la permanencia de la opción CLI. | |||||
| - La suite de política cubre configuración estricta, seis estados, transición | - La suite de política cubre configuración estricta, seis estados, transición | ||||
| temprana, fixture real, telemetría, identidades, protecciones, TERM/KILL, | temprana, fixture real, telemetría, identidades, protecciones, TERM/KILL, | ||||
| recuperación y presupuesto jerárquico. | recuperación y presupuesto jerárquico. | ||||
| @@ -53,8 +57,9 @@ proporciones y procesos `mysqld` protegidos. | |||||
| `kill(2)`. El envío real sigue aislado en el backend nativo y no se enlaza en | `kill(2)`. El envío real sigue aislado en el backend nativo y no se enlaza en | ||||
| las pruebas. | las pruebas. | ||||
| Los resultados exactos se guardan en `logs/policy-tests.log`, | |||||
| `logs/runtime-tests.log`, `logs/sanitizers.log` y `logs/portability.log`. | |||||
| Los resultados exactos se guardan en `logs/distribution-tests.log`, | |||||
| `logs/policy-tests.log`, `logs/runtime-tests.log`, `logs/sanitizers.log` y | |||||
| `logs/portability.log`. | |||||
| ## Propiedades verificadas por las pruebas nuevas | ## Propiedades verificadas por las pruebas nuevas | ||||
| @@ -84,8 +89,9 @@ Los resultados exactos se guardan en `logs/policy-tests.log`, | |||||
| 1. Compilar con cabeceras nativas (`gmake CC=gcc`), ejecutar `gmake test CC=gcc` | 1. Compilar con cabeceras nativas (`gmake CC=gcc`), ejecutar `gmake test CC=gcc` | ||||
| y comprobar ELF de 64 bits y dependencias. | y comprobar ELF de 64 bits y dependencias. | ||||
| 2. Ejecutar `--probe --force-dry-run` y contrastar la telemetría ya conocida. | 2. Ejecutar `--probe --force-dry-run` y contrastar la telemetría ya conocida. | ||||
| 3. Validar el manifiesto con `svccfg validate`, importar y ejecutar SMF sólo con | |||||
| `--force-dry-run`. | |||||
| 3. Validar e importar el manifiesto, confirmar que `start/exec` no contiene | |||||
| `--force-dry-run` y que `event=start` sigue mostrando `mode=dry-run` por la | |||||
| configuración distribuida. | |||||
| 4. Confirmar que el top‑3 es global: los `clamd` grandes de zonas menores deben | 4. Confirmar que el top‑3 es global: los `clamd` grandes de zonas menores deben | ||||
| superar a PHP-FPM pequeños de `web5`, sin incluir ningún `mysqld` protegido. | superar a PHP-FPM pequeños de `web5`, sin incluir ningún `mysqld` protegido. | ||||
| 5. Confirmar que un scan lento/incompleto no retrasa ni borra la decisión | 5. Confirmar que un scan lento/incompleto no retrasa ni borra la decisión | ||||
| @@ -95,6 +101,10 @@ Los resultados exactos se guardan en `logs/policy-tests.log`, | |||||
| 7. Sólo en laboratorio desechable y en una fase posterior: probar PCKILL, | 7. Sólo en laboratorio desechable y en una fase posterior: probar PCKILL, | ||||
| supervisores, cooldown, 4/8/12 y rollback. `armed` continúa siendo NO GO. | supervisores, cooldown, 4/8/12 y rollback. `armed` continúa siendo NO GO. | ||||
| La opción CLI `--force-dry-run` continúa probándose y se conserva para `--probe` | |||||
| y validaciones manuales. Su ausencia se exige únicamente en el manifiesto SMF | |||||
| de producción. | |||||
| ## Límites conocidos | ## Límites conocidos | ||||
| La caché sólo contiene tres procesos y puede quedar sin candidato si todos | La caché sólo contiene tres procesos y puede quedar sin candidato si todos | ||||
| @@ -1,4 +1,4 @@ | |||||
| # o6h-memory-guard 1.0.4 -- whitespace-separated, no shell evaluation. | |||||
| # o6h-memory-guard 1.0.5 -- whitespace-separated, no shell evaluation. | |||||
| # Restart required for configuration changes. Duplicate scalar keys are errors. | # Restart required for configuration changes. Duplicate scalar keys are errors. | ||||
| ACTION_MODE dry-run | ACTION_MODE dry-run | ||||
| @@ -35,7 +35,7 @@ protect_process zabbix_agentd | |||||
| # Inventory supplied by the operator, from vmadm list (outside the daemon). | # Inventory supplied by the operator, from vmadm list (outside the daemon). | ||||
| # Add REAL UUIDs and aliases. No active allow rules are shipped. | # Add REAL UUIDs and aliases. No active allow rules are shipped. | ||||
| # Grammar: zone <lowercase-UUID> <safe-alias-without-spaces> <allow|protect|observe> | # Grammar: zone <lowercase-UUID> <safe-alias-without-spaces> <allow|protect|observe> | ||||
| # allow: eligible in simulations, and in armed only when both arming gates open. | |||||
| # allow: eligible in simulations and for signals only with ACTION_MODE armed. | |||||
| # protect / observe / absent: never eligible for signals, including floor. | # protect / observe / absent: never eligible for signals, including floor. | ||||
| # Examples (replace the entire UUID; these are comments, not authorizations): | # Examples (replace the entire UUID; these are comments, not authorizations): | ||||
| # zone YOUR-REAL-WEB-ZONE-UUID web5 allow | # zone YOUR-REAL-WEB-ZONE-UUID web5 allow | ||||
| @@ -0,0 +1,2 @@ | |||||
| sh tests/test_distribution.sh | |||||
| PASS distribution defaults to ACTION_MODE dry-run; production SMF does not force it | |||||
| @@ -1,5 +1,5 @@ | |||||
| # SYNTHETIC FORMAT EXAMPLE -- NOT HOST TELEMETRY. Fields abridged for readability. | # SYNTHETIC FORMAT EXAMPLE -- NOT HOST TELEMETRY. Fields abridged for readability. | ||||
| 2026-09-21T15:00:00Z mono=100.000 event=start version=1.0.4 pid=999 mode=dry-run page_bytes=4096 armed_warmup=60 | |||||
| 2026-09-21T15:00:00Z mono=100.000 event=start version=1.0.5 pid=999 mode=dry-run page_bytes=4096 armed_warmup=60 | |||||
| 2026-09-18T15:00:01Z mono=101.000 event=sample state=NORMAL action_pressure=0 floor=0 free_pages=425950 lotsfree=130875 desfree=65437 minfree=49077 nscan=0 pp_kernel=2976170 pageslocked=3002379 arc_ok=1 arc_bytes=1073741824 swap_committed_ok=1 swap_committed_pages=7480128 swap_physical_used_ok=1 swap_physical_used_bytes=4143648768 anon_pageout_ok=1 anon_pageout_pages=1000 swap_alloc_pages=7000000 swap_reserved_pages=480128 swap_available_pages=6135486 | 2026-09-18T15:00:01Z mono=101.000 event=sample state=NORMAL action_pressure=0 floor=0 free_pages=425950 lotsfree=130875 desfree=65437 minfree=49077 nscan=0 pp_kernel=2976170 pageslocked=3002379 arc_ok=1 arc_bytes=1073741824 swap_committed_ok=1 swap_committed_pages=7480128 swap_physical_used_ok=1 swap_physical_used_bytes=4143648768 anon_pageout_ok=1 anon_pageout_pages=1000 swap_alloc_pages=7000000 swap_reserved_pages=480128 swap_available_pages=6135486 | ||||
| 2026-09-18T15:00:01Z mono=101.000 event=delta metric=swap_committed_pages d5=NA d15=NA d60=NA | 2026-09-18T15:00:01Z mono=101.000 event=delta metric=swap_committed_pages d5=NA d15=NA d60=NA | ||||
| 2026-09-18T15:00:01Z mono=101.000 event=delta metric=swap_physical_used_bytes d5=NA d15=NA d60=NA | 2026-09-18T15:00:01Z mono=101.000 event=delta metric=swap_physical_used_bytes d5=NA d15=NA d60=NA | ||||
| @@ -1,7 +1,7 @@ | |||||
| make portability | make portability | ||||
| PASS C99 syntax with -Wall -Wextra -Werror -Wformat=2 -pedantic | PASS C99 syntax with -Wall -Wextra -Werror -Wformat=2 -pedantic | ||||
| PASS GCC -fanalyzer for every production translation unit | PASS GCC -fanalyzer for every production translation unit | ||||
| PASS sh -n install.sh | |||||
| PASS sh -n install.sh tests/test_distribution.sh | |||||
| PASS xmllint --nonet --noout smf/o6h-memory-guard.xml | PASS xmllint --nonet --noout smf/o6h-memory-guard.xml | ||||
| NOTE tests/api-sketch are local declarations, not native illumos headers or ABI validation. | NOTE tests/api-sketch are local declarations, not native illumos headers or ABI validation. | ||||
| NOTE clang, clang-tidy, cppcheck, scan-build and shellcheck were not installed. | NOTE clang, clang-tidy, cppcheck, scan-build and shellcheck were not installed. | ||||
| @@ -11,7 +11,7 @@ | |||||
| <method_credential user="root" group="root"/> | <method_credential user="root" group="root"/> | ||||
| </method_context> | </method_context> | ||||
| <exec_method type="method" name="start" | <exec_method type="method" name="start" | ||||
| exec="/opt/custom/bin/o6h-memory-guard --daemon --force-dry-run --config /opt/custom/etc/o6h-memory-guard.conf" | |||||
| exec="/opt/custom/bin/o6h-memory-guard --daemon --config /opt/custom/etc/o6h-memory-guard.conf" | |||||
| timeout_seconds="30"/> | timeout_seconds="30"/> | ||||
| <exec_method type="method" name="stop" exec=":kill" timeout_seconds="30"/> | <exec_method type="method" name="stop" exec=":kill" timeout_seconds="30"/> | ||||
| <property_group name="startd" type="framework"> | <property_group name="startd" type="framework"> | ||||
| @@ -19,7 +19,7 @@ | |||||
| </property_group> | </property_group> | ||||
| <stability value="Unstable"/> | <stability value="Unstable"/> | ||||
| <template> | <template> | ||||
| <common_name><loctext xml:lang="C">o6h memory pressure guard (initially forced dry-run)</loctext></common_name> | |||||
| <common_name><loctext xml:lang="C">o6h memory pressure guard</loctext></common_name> | |||||
| </template> | </template> | ||||
| </service> | </service> | ||||
| </service_bundle> | </service_bundle> | ||||
| @@ -13,7 +13,7 @@ | |||||
| #define CONF_PATH "/opt/custom/etc/o6h-memory-guard.conf" | #define CONF_PATH "/opt/custom/etc/o6h-memory-guard.conf" | ||||
| #define LOG_DIR "/opt/custom/var/log/o6h-memory-guard" | #define LOG_DIR "/opt/custom/var/log/o6h-memory-guard" | ||||
| #define RUN_DIR "/opt/custom/var/run" | #define RUN_DIR "/opt/custom/var/run" | ||||
| #define VERSION "1.0.4" | |||||
| #define VERSION "1.0.5" | |||||
| enum state { NORMAL, PRE_PRESSURE, PRESSURE, CRITICAL, EMERGENCY, RECOVERY }; | enum state { NORMAL, PRE_PRESSURE, PRESSURE, CRITICAL, EMERGENCY, RECOVERY }; | ||||
| enum policy { OBSERVE, ALLOW, PROTECT }; | enum policy { OBSERVE, ALLOW, PROTECT }; | ||||
| @@ -0,0 +1,34 @@ | |||||
| #!/bin/sh | |||||
| set -eu | |||||
| manifest=smf/o6h-memory-guard.xml | |||||
| config=etc/o6h-memory-guard.conf | |||||
| if grep -Fq -- '--force-dry-run' "$manifest"; then | |||||
| echo 'FAIL SMF manifest must not force dry-run' >&2 | |||||
| exit 1 | |||||
| fi | |||||
| test "$(grep -Fxc ' exec="/opt/custom/bin/o6h-memory-guard --daemon --config /opt/custom/etc/o6h-memory-guard.conf"' "$manifest")" -eq 1 | |||||
| test "$(grep -Fxc ' <common_name><loctext xml:lang="C">o6h memory pressure guard</loctext></common_name>' "$manifest")" -eq 1 | |||||
| test "$(grep -Fxc 'ACTION_MODE dry-run' "$config")" -eq 1 | |||||
| while IFS= read -r setting; do | |||||
| test "$(grep -Fxc "$setting" "$config")" -eq 1 | |||||
| done <<'EOF' | |||||
| PRE_SECONDS 1 | |||||
| PRESSURE_SECONDS 2 | |||||
| CRITICAL_SECONDS 2 | |||||
| RECOVERY_SECONDS 15 | |||||
| CRITICAL_TERM_GRACE_SECONDS 5 | |||||
| EMERGENCY_TERM_GRACE_SECONDS 1 | |||||
| FLOOR_KILL_DELAY_SECONDS 0 | |||||
| MAX_CACHED_CANDIDATE_AGE_SECONDS 15 | |||||
| MAX_VICTIMS_EPISODE 4 | |||||
| MAX_VICTIMS_MINUTE 4 | |||||
| MAX_EMERGENCY_VICTIMS_EPISODE 8 | |||||
| MAX_FLOOR_VICTIMS_EPISODE 12 | |||||
| EOF | |||||
| grep -Fq -- '"--force-dry-run"' src/main.c | |||||
| echo 'PASS distribution defaults to ACTION_MODE dry-run; production SMF does not force it' | |||||