/mandos/trunk

To get this branch, use:
bzr branch http://bzr.recompile.se/loggerhead/mandos/trunk

« back to all changes in this revision

Viewing changes to debian/mandos-client.README.Debian

  • Committer: Teddy Hogeborn
  • Date: 2024-09-08 00:08:15 UTC
  • Revision ID: teddy@recompile.se-20240908000815-x3gr5xion3kyyoio
Improve documentation

* mandos.conf.xml (DESCRIPTION): Remove the unnecessary word "simple".
* plugin-runner.xml (PLUGINS): Remove the unnecessary word "simply",
  and add the "executable" qualifier to the description of plugins.
* mandos-client.xml (DESCRIPTION, OPTIONS): Do not refer to
  "plugin-runner"; instead refer to the section "OVERVIEW".
  (OVERVIEW): Don't only describe plugin-runner; also describe
  how password-agent can start mandos-client.
  (EXAMPLE): Do not refer to "plugin-runner"; instead refer to the
  section "OVERVIEW".
  (SEE ALSO): Replace reference to "password-prompt" with
  "password-agent".

Show diffs side-by-side

added added

removed removed

Lines of Context:
49
49
  setting is changed, it will be necessary to update the initrd image
50
50
  by running this command:
51
51
  
 
52
        (For initramfs-tools:)
52
53
        update-initramfs -k all -u
 
54
        
 
55
        (For dracut:)
 
56
        dpkg-reconfigure dracut
53
57
  
54
58
  The device can also be overridden at boot time on the Linux kernel
55
59
  command line using the sixth colon-separated field of the "ip="
60
64
  Note that since the network interfaces are used in the initial RAM
61
65
  disk environment, the network interfaces *must* exist at that stage.
62
66
  Thus, an interface can *not* be a pseudo-interface such as "br0" or
63
 
  "tun0"; instead, only real interfaces (such as "eth0") can be used.
64
 
  This can be overcome by writing a "network hook" program to create
65
 
  an interface (see mandos-client(8mandos)) and placing it in
66
 
  "/etc/mandos/network-hooks.d", from where it will be copied into the
67
 
  initial RAM disk.  Example network hook scripts can be found in
68
 
  "/usr/share/doc/mandos-client/examples/network-hooks.d".
 
67
  "tun0"; instead, only real interfaces (such as "enp1s0" or "eth0")
 
68
  can be used. This can be overcome by writing a "network hook"
 
69
  program to create an interface (see mandos-client(8mandos)) and
 
70
  placing it in "/etc/mandos/network-hooks.d", from where it will be
 
71
  copied into the initial RAM disk.  Example network hook scripts can
 
72
  be found in "/usr/share/doc/mandos-client/examples/network-hooks.d".
69
73
 
70
74
* User-Supplied Plugins
71
75
  
73
77
  to the normal Mandos plugins.  When adding or changing plugins, do
74
78
  not forget to update the initital RAM disk image:
75
79
  
 
80
        (For initramfs-tools:)
76
81
        update-initramfs -k all -u
 
82
        
 
83
        (For dracut:)
 
84
        dpkg-reconfigure dracut
77
85
 
78
86
* Do *NOT* Edit "/etc/crypttab"
79
87
  
108
116
  policy or other reasons, simply replace the existing dhparams.pem
109
117
  file and update the initital RAM disk image.
110
118
 
111
 
 -- Teddy Hogeborn <teddy@recompile.se>, Sat,  9 Feb 2019 15:08:04 +0100
 
119
 -- Teddy Hogeborn <teddy@recompile.se>, Mon, 15 Jul 2019 16:47:02 +0200