> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fau.fpt.icu/llms.txt
> Use this file to discover all available pages before exploring further.

# Instrumentum Diagnosticum (doctor)

> Exsequere verificatiónes sanitatis ad diagnosticandum problemata configurationis et instrumentorum.

<Tip>
  Exsequere `doctor` primum quotiens comportamentum inopinatum reperis. Cito exponit directoria absentia, formulas quae analysi subici non possunt, lockfile obsoletum et instrumenta absentia antequam altius te immergas.
</Tip>

Mandatum `doctor` configurationem localem tuam inspicit et statum cuiusque verificationis refert:

```bash theme={null}
fp-appimage-updater doctor
```

## Verificationes exsecutae

| Verificatio           | Quid verificat                                                  |
| --------------------- | --------------------------------------------------------------- |
| `config_dir`          | Directorium configurationis existit                             |
| `apps_dir`            | Subdirectorium applicationum existit                            |
| `global_config`       | Fasciculus globalis `config.yml` adest et analysi subici potest |
| `state_dir`           | Directorium status accessibile est                              |
| `parsed_app_recipes`  | Numerus fasciculorum formulae qui cum successu cargarunt        |
| `invalid_app_recipes` | Numerus fasciculorum formulae qui in analysi defecerunt         |
| `process_lock`        | Si lockfile currentis abest, activus vel obsoletus est          |
| `github_api`          | Conexio API GitHub et validitas tesserae                        |

Quaeque verificatio refert `ok` vel `warn`. Resultatum `warn` instrumentum currere non impedit, sed comportamentum inopinatum explicare potest.

`process_lock` refert `warn` cum lockfile obsoletus vel malformatus videtur. Hoc plerumque significat exsecutionem priorem inopinate finitam esse, et proxima exsecutio eum purgare poterit.

`doctor` fasciculos locales, instrumenta localia verificat, et levem petitionem ad API GitHub peragit ad limitem ratae et statum tesserae tuae verificandum.

<Note>
  Adde `--json` ad obtinendum exitum legibilem a machina idoneum pro scriptis vel monitione:

  ```bash theme={null}
  fp-appimage-updater doctor --json
  ```
</Note>

## Problemata communia

**Fasciculi formulae in analysi defecerunt**

Exsequere `validate` ad identificandos qui fasciculi errores habent et quis error analysis sit:

```bash theme={null}
fp-appimage-updater validate
```

Ad verificandum unicam formulam per nomen:

```bash theme={null}
fp-appimage-updater validate <nomen-app>
```

***

**Directorium configurationis non inventum**

Initialisa directorium configurationis cum:

```bash theme={null}
fp-appimage-updater init --global
```

Hoc creat structuram directoriorum exspectatam et `config.yml` initialem.