Источники и карта исходников
Файлы реализации и технические документы для разработки самой Altera. Контракты клиентов и модулей описаны в профильных разделах документации.
Карта исходников
| Файл | Область |
|---|---|
Cargo.toml | Версия, MSRV, features и зависимости |
.gear/altera.spec | RPM-сборка, пакеты, установка |
src/routes.rs | HTTP/WebSocket-маршруты, login/logout и проверка Bearer-сессии |
src/routes/web.rs | WebSocket ↔ sessions-канал, heartbeat, обёртки маршрутов и отображение ошибок |
src/bin/altera-cli.rs | Unix-клиент JSON Lines, stdin/stdout, выбор модуля аргументом, специальный /upload |
src/routes/connection.rs | Мультиплексирование, module sessions, очереди, запуск/остановка |
src/sessions/pam.rs | PAM, выдача Bearer-сессий, получение UID/GID |
src/polkit.rs | Action ID, Subject, обращения к Polkit |
src/routes/process.rs | Backend-процесс, process group, cleanup, stderr |
src/routes/writes.rs | Общий реестр блокировок и уведомлений |
src/main.rs | Запуск Unix listener основной службы, определение Unix peer |
src/lib.rs | Пути и настройки окружения |
src/routes/web/ui.rs | Отдача статических ресурсов |
src/routes/web/upload.rs | Протокол файлов, размещение, метаданные, очистка |
src/routes/authorization.rs | Разбор обычного/интерактивного запроса и диалог |
src/unix_peer.rs | Идентификация процесса и выбранный peer-протокол |
docs/backend3/module.md | Правила модулей backend3 |
src/routes/backend3/ask_backend.rs | Сериализация запросов backend3 |
src/routes/backend3/read.rs | Разбор ответов backend3 |
.gear/.pam.d/altera | PAM service auth/account |
docs/polkit.md | Протокол клиентского диалога Polkit |
docs/backend4/module.md | Правила модулей backend4 |
altera_python_functions.py | Помощник Python backend4 |
altera-sh-functions | Помощник shell backend4 |
src/routes/backend4/ask_backend.rs | Сериализация запросов backend4 |
src/routes/backend4/read.rs | JSON-данные и Completed |
docs/upload.md | Клиентский upload-протокол |
README.MD | Обзор и текущие пользовательские инструкции |
.gear/altera.service | Системная служба |
src/sessions.rs | Хранение токенов, TTL, отзыв и оповещение WebSocket-соединений |
src/bin/altera-web.rs | Запуск HTTP/TLS listener, ограничения подключений и handshake |
src/bin/altera-sessions.rs | Запуск службы сессий, доступ к её Unix-сокету, очистка истёкших сессий |
src/sessions/protocol.rs | JSON Lines, управляющие запросы sessions, сериализация ошибок |
src/sessions/client.rs | Подключение web к sessions и ожидание первоначального ответа |
src/sessions/server.rs | Проверка сессии, запуск CLI от имени пользователя, контроль его завершения |
src/sessions/transport.rs | Побайтовая передача между sessions-каналом и stdin/stdout CLI |
src/error.rs | Общие типы ошибок, публичные коды и сообщения |
src/unix_peer/legacy.rs | Идентификация с /proc-дескриптором перед JSON-обменом |
src/polkit/agent.rs | Реализация authentication agent |
Внешние справочные материалы: E1 — стандарт браузерного WebSocket; E2 — документированное поведение Unix CommandExt::uid.