summaryrefslogtreecommitdiff
path: root/man/man1/monkeysphere.1
blob: f9a6af47537551551391ee064f9bdd54372c718b (plain) 
    

  1. .TH MONKEYSPHERE "1" "June 2008" "monkeysphere 0.1" "User Commands"
    2. 

  2. .SH NAME
    3. 

  3. monkeysphere \- monkeysphere client user interface
    4. 

  4. .SH SYNOPSIS
    5. 

  5. .B monkeysphere \fIcommand\fP [\fIargs\fP]
    6. 

  6. .SH DESCRIPTION
    7. 

  7. .PP
    8. 

  8. \fBmonkeysphere\fP is the client monkeysphere tool.
    9. 

  9. .SH SUBCOMMANDS
    10. 

  10. \fBmonkeysphere\fP takes various subcommands:
    11. 

  11. .PD
    12. 

  12. .TP
    13. 

  13. .B update-known_hosts [HOST]...
    14. 

  14. Update the known_hosts file.  For every host listed, search for a gpg
    15. 

  15. key for the host in the Web of Trust.  If a key is found, any ssh keys
    16. 

  16. for the host are removed from the known_hosts file.  If the found key
    17. 

  17. is acceptable (see KEY ACCEPTABILITY), then the gpg key is converted
    18. 

  18. to an ssh key and added to the known_hosts file.  If no gpg key is
    19. 

  19. found for the host, then nothing is done.  If no hosts are specified,
    20. 

  20. all hosts listed in the known_hosts file will be processed.  If they
    21. 

  21. 

  22. `k' may be used in place of `update-known_hosts'.
    23. 

  23. .TP
    24. 

  24. .B update-authorized_keys
    25. 

  25. Update the authorized_keys file.
    26. 

  26. .TP
    27. 

  27. .B update-userids [USERID]...
    28. 

  28. Update userid
    29. 

  29. .TP
    30. 

  30. .B gen-ae-subkey KEYID
    31. 

  31. Generate an `ae` capable subkey
    32. 

  32. .TP
    33. 

  33. .B help
    34. 

  34. Output a brief usage summary.  `h' or `?' may be used in place of
    35. 

  35. `help'.
    36. 

  36. .PD
    37. 

  37. .SH KEY ACCEPTABILITY
    38. 

  38. GPG keys are considered acceptable if the following criteria are met:
    39. 

  39. .PD
    40. 

  40. .TP
    41. 

  41. .B capability
    42. 

  42. The key must have both the "authentication" and "encrypt" capability
    43. 

  43. flags.
    44. 

  44. .TP
    45. 

  45. .B validity
    46. 

  46. The key must be "fully" valid, and must not be expired or revoked.
    47. 

  47. .PD
    48. 

  48. .SH FILES
    49. 

  49. .PD 1
    50. 

  50. .TP
    51. 

  51. ~/.config/monkeysphere/monkeysphere.conf
    52. 

  52. User monkeysphere config file.
    53. 

  53. .TP
    54. 

  54. /etc/monkeysphere/monkeysphere.conf
    55. 

  55. System-wide monkeysphere config file.
    56. 

  56. .TP
    57. 

  57. ~/.config/monkeysphere/authorized_user_ids
    58. 

  58. GPG user IDs to validate for addition to the authorized_keys file.
    59. 

  59. .TP
    60. 

  60. ~/.config/monkeysphere/authorized_keys
    61. 

  61. Monkeysphere generated authorized_keys file.
    62. 

  62. .TP
    63. 

  63. ~/.config/monkeysphere/user_keys
    64. 

  64. User keys cache directory.
    65. 

  65. .TP
    66. 

  66. ~/.config/monkeysphere/host_keys
    67. 

  67. Host keys cache directory.
    68. 

  68. .PD
    69. 

  69. .SH AUTHOR
    70. 

  70. Written by Jameson Rollins
    71. 

  71. .SH "REPORTING BUGS"
    72. 

  72. Report bugs to <???@???>.
    73. 

  73. .SH COPYRIGHT
    74. 

  74. Copyright \(co 2008 Jameson Graef Rollins and Daniel Kahn Gillmor
    75. 

  75. .br
    76. 

  76. This is free software.  You may redistribute copies of it under the
    77. 

  77. terms of the GNU General Public License
    78. 

  78. <http://www.gnu.org/licenses/gpl.html>.  There is NO WARRANTY, to the
    79. 

  79. extent permitted by law.
    80. 

  80. .SH "SEE ALSO"
    81. 

  81. .BR ssh (1),
    82. 

  82. .BR gpg (1),
    83. 

  83. .BR monkeysphere-server (8)
    84.
generated by cgit v1.2.3 (git 2.39.1) at 2024-06-28 19:22:22 +0000