Line data Source code
1 : /* ks-engine-kdns.c - KDNS OpenPGP key access
2 : * Copyright (C) 2011 Free Software Foundation, Inc.
3 : *
4 : * This file is part of GnuPG.
5 : *
6 : * GnuPG is free software; you can redistribute it and/or modify
7 : * it under the terms of the GNU General Public License as published by
8 : * the Free Software Foundation; either version 3 of the License, or
9 : * (at your option) any later version.
10 : *
11 : * GnuPG is distributed in the hope that it will be useful,
12 : * but WITHOUT ANY WARRANTY; without even the implied warranty of
13 : * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 : * GNU General Public License for more details.
15 : *
16 : * You should have received a copy of the GNU General Public License
17 : * along with this program; if not, see <http://www.gnu.org/licenses/>.
18 : */
19 :
20 : #include <config.h>
21 :
22 : #include <stdio.h>
23 : #include <stdlib.h>
24 : #include <string.h>
25 : #include <assert.h>
26 :
27 : #include "dirmngr.h"
28 : #include "misc.h"
29 : #include "userids.h"
30 : #include "ks-engine.h"
31 :
32 : /* Print a help output for the schemata supported by this module. */
33 : gpg_error_t
34 0 : ks_kdns_help (ctrl_t ctrl, parsed_uri_t uri)
35 : {
36 0 : const char const data[] =
37 : "This keyserver engine accepts URLs of the form:\n"
38 : " kdns://[NAMESERVER]/[ROOT][?at=STRING]\n"
39 : "with\n"
40 : " NAMESERVER used for queries (default: system standard)\n"
41 : " ROOT a DNS name appended to the query (default: none)\n"
42 : " STRING a string to replace the '@' (default: \".\")\n"
43 : "If a long answer is expected add the parameter \"usevc=1\".\n"
44 : "Supported methods: fetch\n"
45 : "Example:\n"
46 : "A query for \"hacker@gnupg.org\" with\n"
47 : " kdns://10.0.0.1/example.net?at=_key_&usevc=1\n"
48 : "setup as --auto-key-lookup in gpg does a CERT record query\n"
49 : "with type PGP on the nameserver 10.0.0.1 for\n"
50 : " hacker._key_.gnupg.org.example.net";
51 : gpg_error_t err;
52 :
53 0 : if (!uri)
54 0 : err = ks_print_help (ctrl, " kdns");
55 0 : else if (!strcmp (uri->scheme, "kdns"))
56 0 : err = ks_print_help (ctrl, data);
57 : else
58 0 : err = 0;
59 :
60 0 : return err;
61 : }
62 :
63 :
64 : /* Get the key from URI which is expected to specify a kdns scheme.
65 : On success R_FP has an open stream to read the data. */
66 : gpg_error_t
67 0 : ks_kdns_fetch (ctrl_t ctrl, parsed_uri_t uri, estream_t *r_fp)
68 : {
69 : gpg_error_t err;
70 :
71 : (void)ctrl;
72 0 : *r_fp = NULL;
73 :
74 0 : if (strcmp (uri->scheme, "kdns"))
75 0 : return gpg_error (GPG_ERR_INV_ARG);
76 :
77 0 : err = gpg_error (GPG_ERR_NOT_IMPLEMENTED);
78 0 : return err;
79 : }
|