File: README.org

package info (click to toggle)
libconfig-model-openssh-perl 2.9.9.1-1
  • links: PTS, VCS
  • area: main
  • in suites: forky, sid, trixie
  • size: 640 kB
  • sloc: perl: 4,596; makefile: 12
file content (31 lines) | stat: -rw-r--r-- 1,284 bytes parent folder | download
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
This directory contains a utility to regenerate ssh and sshd model
using the data provided by ssh_config and sshd_config man page.

The ~parse-man.pl~ program works this way:
- ssh man page is converted to HTML with ~roff2html~
- The list of configuration parameter and its description is extracted
  from the HTML
- The description is parsed to generate ssh model
- the same steps are applied for ~sshd_config~ man page

Unfortunately, extracting a model from unstructured data (like a
parameter description) is not bullet proof so:
- the model of some parameter is hardcoded in ~lib/ParseMan.pm~
- extra information is hardcoded in yaml files.

Here's the content of this directory:
- ~parse-man.pl~ : the generator program
- ~lib/ParseMan.pm~: a Perl library for ~parse-man.pl~
- ~ssh-fixup.yaml~: extra model information for ssh model
- ~sshd-fixup.yaml~: likewise for sshd
- ~systemssh.yml~: skeleton model for system ssh model
- ~fixup-element-ipqos.yml~: extra information for ~IPQoS~ parameter
  used by both ssh and sshd models
- ~sshd-matchblock.yml~: skeleton model for ~Sshd::MatchBlock~
  configuration class
- ~sshd-matchcondition.yml~: model for ~Sshd::MatchCondition~
  configuration class
- ~ssh-portforward.yml~: model for ~Ssh::PortForward~ configuration
  class