1 ;;; Copyright (C) 1987,88,89,90,92,93,94,95,96 Free Software Foundation, Inc.
3 ;; Author: Lars Magne Ingebrigtsen <larsi@ifi.uio.no>
6 ;; This file is part of GNU Emacs.
8 ;; GNU Emacs is free software; you can redistribute it and/or modify
9 ;; it under the terms of the GNU General Public License as published by
10 ;; the Free Software Foundation; either version 2, or (at your option)
13 ;; GNU Emacs is distributed in the hope that it will be useful,
14 ;; but WITHOUT ANY WARRANTY; without even the implied warranty of
15 ;; MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
16 ;; GNU General Public License for more details.
18 ;; You should have received a copy of the GNU General Public License
19 ;; along with GNU Emacs; see the file COPYING. If not, write to
20 ;; the Free Software Foundation, 675 Mass Ave, Cambridge, MA 02139, USA.
33 (unless (fboundp 'open-network-stream)
36 (eval-when-compile (require 'cl))
38 (defvoo nntp-address nil
39 "Address of the physical nntp server.")
41 (defvoo nntp-port-number "nntp"
42 "Port number on the physical nntp server.")
44 (defvoo nntp-server-opened-hook '(nntp-send-mode-reader)
45 "*Hook used for sending commands to the server at startup.
46 The default value is `nntp-send-mode-reader', which makes an innd
47 server spawn an nnrpd server. Another useful function to put in this
48 hook might be `nntp-send-authinfo', which will prompt for a password
49 to allow posting from the server. Note that this is only necessary to
50 do on servers that use strict access control.")
52 (defvoo nntp-authinfo-function 'nntp-send-authinfo
53 "Function used to send AUTHINFO to the server.")
55 (defvoo nntp-server-action-alist
56 '(("nntpd 1\\.5\\.11t"
57 (remove-hook 'nntp-server-opened-hook 'nntp-send-mode-reader))
58 ("NNRP server Netscape"
59 (setq nntp-server-list-active-group nil)))
60 "Alist of regexps to match on server types and actions to be taken.
61 For instance, if you want Gnus to beep every time you connect
62 to innd, you could say something like:
64 \(setq nntp-server-action-alist
67 You probably don't want to do that, though.")
69 (defvoo nntp-open-connection-function 'nntp-open-network-stream
70 "*Function used for connecting to a remote system.
71 It will be called with the buffer to output in.
73 Two pre-made functions are `nntp-open-network-stream', which is the
74 default, and simply connects to some port or other on the remote
75 system (see nntp-port-number). The other are `nntp-open-rlogin', which
76 does an rlogin on the remote system, and then does a telnet to the
77 NNTP server available there (see nntp-rlogin-parameters) and `nntp-open-telnet' which
78 telnets to a remote system, logs in and does the same")
80 (defvoo nntp-rlogin-parameters '("telnet" "-8" "${NNTPSERVER:=news}" "nntp")
81 "*Parameters to `nntp-open-login'.
82 That function may be used as `nntp-open-server-function'. In that
83 case, this list will be used as the parameter list given to rsh.")
85 (defvoo nntp-rlogin-user-name nil
86 "*User name on remote system when using the rlogin connect method.")
88 (defvoo nntp-telnet-parameters '("exec" "telnet" "-8" "${NNTPSERVER:=news}" "nntp")
89 "*Parameters to `nntp-open-telnet'.
90 That function may be used as `nntp-open-server-function'. In that
91 case, this list will be executed as a command after logging in
94 (defvoo nntp-telnet-user-name nil
95 "User name to log in via telnet with.")
97 (defvoo nntp-telnet-passwd nil
98 "Password to use to log in via telnet with.")
100 (defvoo nntp-end-of-line "\r\n"
101 "String to use on the end of lines when talking to the NNTP server.
102 This is \"\\r\\n\" by default, but should be \"\\n\" when
103 using rlogin or telnet to communicate with the server.")
105 (defvoo nntp-large-newsgroup 50
106 "*The number of the articles which indicates a large newsgroup.
107 If the number of the articles is greater than the value, verbose
108 messages will be shown to indicate the current status.")
110 (defvoo nntp-maximum-request 400
111 "*The maximum number of the requests sent to the NNTP server at one time.
112 If Emacs hangs up while retrieving headers, set the variable to a
115 (defvoo nntp-nov-is-evil nil
116 "*If non-nil, nntp will never attempt to use XOVER when talking to the server.")
118 (defvoo nntp-xover-commands '("XOVER" "XOVERVIEW")
119 "*List of strings that are used as commands to fetch NOV lines from a server.
120 The strings are tried in turn until a positive response is gotten. If
121 none of the commands are successful, nntp will just grab headers one
124 (defvoo nntp-nov-gap 20
125 "*Maximum allowed gap between two articles.
126 If the gap between two consecutive articles is bigger than this
127 variable, split the XOVER request into two requests.")
129 (defvoo nntp-connection-timeout nil
130 "*Number of seconds to wait before an nntp connection times out.
131 If this variable is nil, which is the default, no timers are set.")
133 (defvoo nntp-prepare-server-hook nil
134 "*Hook run before a server is opened.
135 If can be used to set up a server remotely, for instance. Say you
136 have an account at the machine \"other.machine\". This machine has
137 access to an NNTP server that you can't access locally. You could
138 then use this hook to rsh to the remote machine and start a proxy NNTP
139 server there that you can connect to. See also `nntp-open-connection-function'")
141 (defvoo nntp-warn-about-losing-connection t
142 "*If non-nil, beep when a server closes connection.")
146 ;;; Internal variables.
148 (defvar nntp-process-wait-for nil)
149 (defvar nntp-process-to-buffer nil)
150 (defvar nntp-process-callback nil)
151 (defvar nntp-process-decode nil)
152 (defvar nntp-process-start-point nil)
153 (defvar nntp-inside-change-function nil)
155 (defvar nntp-connection-list nil)
157 (defvoo nntp-server-type nil)
158 (defvoo nntp-connection-alist nil)
159 (defvoo nntp-status-string "")
160 (defconst nntp-version "nntp 5.0")
161 (defvoo nntp-inhibit-erase nil)
163 (defvoo nntp-server-xover 'try)
164 (defvoo nntp-server-list-active-group 'try)
167 (autoload 'nnmail-read-passwd "nnmail"))
171 ;;; Interface functions.
173 (nnoo-define-basics nntp)
175 (deffoo nntp-retrieve-headers (articles &optional group server fetch-old)
176 "Retrieve the headers of ARTICLES."
177 (nntp-possibly-change-group group server)
179 (set-buffer (nntp-find-connection-buffer nntp-server-buffer))
181 (if (and (not gnus-nov-is-evil)
182 (not nntp-nov-is-evil)
183 (nntp-retrieve-headers-with-xover articles fetch-old))
184 ;; We successfully retrieved the headers via XOVER.
186 ;; XOVER didn't work, so we do it the hard, slow and inefficient
188 (let ((number (length articles))
191 (last-point (point-min))
192 (buf (nntp-find-connection-buffer nntp-server-buffer))
193 (nntp-inhibit-erase t))
194 ;; Send HEAD command.
198 "HEAD" (if (numberp (car articles))
199 (int-to-string (car articles))
200 ;; `articles' is either a list of article numbers
201 ;; or a list of article IDs.
203 (setq articles (cdr articles)
205 ;; Every 400 header requests we have to read the stream in
206 ;; order to avoid deadlocks.
207 (when (or (null articles) ;All requests have been sent.
208 (zerop (% count nntp-maximum-request)))
209 (nntp-accept-response)
213 (goto-char last-point))