1 ;;; dig.el --- Domain Name System dig interface
3 ;; Copyright (C) 2000, 2001, 2002, 2003, 2004,
4 ;; 2005, 2006, 2007, 2008, 2009, 2010 Free Software Foundation, Inc.
6 ;; Author: Simon Josefsson <simon@josefsson.org>
7 ;; Keywords: DNS BIND dig comm
9 ;; This file is part of GNU Emacs.
11 ;; GNU Emacs is free software: you can redistribute it and/or modify
12 ;; it under the terms of the GNU General Public License as published by
13 ;; the Free Software Foundation, either version 3 of the License, or
14 ;; (at your option) any later version.
16 ;; GNU Emacs is distributed in the hope that it will be useful,
17 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
18 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
19 ;; GNU General Public License for more details.
21 ;; You should have received a copy of the GNU General Public License
22 ;; along with GNU Emacs. If not, see <http://www.gnu.org/licenses/>.
26 ;; This provide an interface for "dig".
28 ;; For interactive use, try M-x dig and type a hostname. Use `q' to quit
31 ;; For use in elisp programs, call `dig-invoke' and use
32 ;; `dig-extract-rr' to extract resource records.
36 ;; 2000-10-28 posted on gnu.emacs.sources
40 (eval-when-compile (require 'cl))
46 (defcustom dig-program "dig"
47 "Name of dig (domain information groper) binary."
51 (defcustom dig-dns-server nil
53 If nil, use system defaults."
54 :type '(choice (const :tag "System defaults")
58 (defcustom dig-font-lock-keywords
59 '(("^;; [A-Z]+ SECTION:" 0 font-lock-keyword-face)
60 ("^;;.*" 0 font-lock-comment-face)
61 ("^; <<>>.*" 0 font-lock-type-face)
62 ("^;.*" 0 font-lock-function-name-face))
63 "Default expressions to highlight in dig mode."
67 (defun dig-invoke (domain &optional
68 query-type query-class query-option
70 "Call dig with given arguments and return buffer containing output.
71 DOMAIN is a string with a DNS domain. QUERY-TYPE is an optional
72 string with a DNS type. QUERY-CLASS is an optional string with a DNS
73 class. QUERY-OPTION is an optional string with dig \"query options\".
74 DIG-OPTION is an optional string with parameters for the dig program.
75 SERVER is an optional string with a domain name server to query.
77 Dig is an external program found in the BIND name server distribution,
78 and is a commonly available debugging tool."
80 (setq buf (generate-new-buffer "*dig output*"))
81 (if dig-option (push dig-option cmdline))
82 (if query-option (push query-option cmdline))
83 (if query-class (push query-class cmdline))
84 (if query-type (push query-type cmdline))
86 (if server (push (concat "@" server) cmdline)
87 (if dig-dns-server (push (concat "@" dig-dns-server) cmdline)))
88 (apply 'call-process dig-program nil buf nil cmdline)
91 (defun dig-extract-rr (domain &optional type class)
92 "Extract resource records for DOMAIN, TYPE and CLASS from buffer.
93 Buffer should contain output generated by `dig-invoke'."
95 (goto-char (point-min))
96 (if (re-search-forward
97 (concat domain "\\.?[\t ]+[0-9wWdDhHmMsS]+[\t ]+"
98 (upcase (or class "IN")) "[\t ]+" (upcase (or type "A")))
105 (when (search-forward " (" e t)
106 (search-forward " )"))
109 (buffer-substring b e))
110 (and (re-search-forward (concat domain "\\.?[\t ]+[0-9wWdDhHmMsS]+[\t ]+"
111 (upcase (or class "IN"))
112 "[\t ]+CNAME[\t ]+\\(.*\\)$") nil t)
113 (dig-extract-rr (match-string 1) type class)))))
115 (defun dig-rr-get-pkix-cert (rr)
117 (string-match "[^\t ]+[\t ]+[0-9wWdDhHmMsS]+[\t ]+IN[\t ]+CERT[\t ]+\\(1\\|PKIX\\)[\t ]+[0-9]+[\t ]+[0-9]+[\t ]+(?" rr)
118 (setq b (match-end 0))
119 (string-match ")" rr)
120 (setq e (match-beginning 0))
121 (setq str (substring rr b e))
122 (while (string-match "[\t \n\r]" str)
123 (setq str (replace-match "" nil nil str)))
126 ;; XEmacs does it like this. For Emacs, we have to set the
127 ;; `font-lock-defaults' buffer-local variable.
128 (put 'dig-mode 'font-lock-defaults '(dig-font-lock-keywords t))
130 (put 'dig-mode 'mode-class 'special)
133 (let ((map (make-sparse-keymap)))
134 (suppress-keymap map)
135 (define-key map "q" 'dig-exit)
138 (define-derived-mode dig-mode nil "Dig"
139 "Major mode for displaying dig output."
140 (buffer-disable-undo)
141 (unless (featurep 'xemacs)
142 (set (make-local-variable 'font-lock-defaults)
143 '(dig-font-lock-keywords t)))
144 (when (featurep 'font-lock)
145 ;; FIXME: what is this for?? --Stef
146 (font-lock-set-defaults))
150 "Quit dig output buffer."
152 (kill-buffer (current-buffer)))
155 (defun dig (domain &optional
156 query-type query-class query-option dig-option server)
157 "Query addresses of a DOMAIN using dig, by calling `dig-invoke'.
158 Optional arguments are passed to `dig-invoke'."
159 (interactive "sHost: ")
161 (dig-invoke domain query-type query-class query-option dig-option server))
162 (goto-char (point-min))
163 (and (search-forward ";; ANSWER SECTION:" nil t)
166 (setq buffer-read-only t)
167 (set-buffer-modified-p nil))
169 ;; named for consistency with query-dns in dns.el
170 (defun query-dig (domain &optional
171 query-type query-class query-option dig-option server)
172 "Query addresses of a DOMAIN using dig.
173 It works by calling `dig-invoke' and `dig-extract-rr'.
174 Optional arguments are passed to `dig-invoke' and `dig-extract-rr'.
175 Returns nil for domain/class/type queries that result in no data."
176 (let ((buffer (dig-invoke domain query-type query-class
177 query-option dig-option server)))
179 (switch-to-buffer buffer)
180 (let ((digger (dig-extract-rr domain query-type query-class)))