The name of the foreign group can be the same as a native group. In
fact, you can subscribe to the same group from as many different servers
you feel like. There will be no name collisions.
is run after a connection has been made. It can be used to send
commands to the NNTP server after it has been contacted. By
default it sends the command
MODE READER to the server with the
nntp-send-mode-reader function. This function should always be
present in this hook.
This function will be used to send `
AUTHINFO' to the NNTP
server. The default function is
nntp-send-authinfo, which looks
through your `
~/.authinfo' (or whatever you've set the
nntp-authinfo-file variable to) for applicable entries. If none
are found, it will prompt you for a login name and a password. The
format of the `
~/.authinfo' file is (almost) the same as the
~/.netrc' file, which is defined in the
manual page, but here are the salient facts:
The file contains one or more line, each of which define one server.
Each line may contain an arbitrary number of token/value pairs. The
valid tokens include `
default' and `
force'. (The latter is not a valid
ftp token, which is the only way the
.authinfo' file format deviates from the `
Here's an example file:
machine news.uio.no login larsi password geheimnis
machine nntp.ifi.uio.no login larsi force yes
The token/value pairs may appear in any order; `
have to be first, for instance.
In this example, both login name and password have been supplied for the
former server, while the latter has only the login name listed, and the
user will be prompted for the password. The latter also has the
force' tag, which means that the authinfo will be sent to the
nntp server upon connection; the default (i.e., when there is not
force' tag) is to not send authinfo to the nntp server
until the nntp server asks for it.
You can also add `
default' lines that will apply to all servers
that don't have matching `
default force yes
This will force sending `
AUTHINFO' commands to all servers not
Remember to not leave the `
~/.authinfo' file world-readable.
This is a list of regexps to match on server types and actions to be
taken when matches are made. For instance, if you want Gnus to beep
every time you connect to innd, you could say something like:
You probably don't want to do that, though.
The default value is
(remove-hook 'nntp-server-opened-hook 'nntp-send-mode-reader)))
This ensures that Gnus doesn't send the
MODE READER command to
nntpd 1.5.11t, since that command chokes that server, I've been told.
If the NNTP server doesn't support NOV headers, this backend
will collect headers by sending a series of
head commands. To
speed things up, the backend sends lots of these commands without
waiting for reply, and then reads all the replies. This is controlled
nntp-maximum-request variable, and is 400 by default. If
your network is buggy, you should set this to 1.
If you have lots of foreign
nntp groups that you connect to
regularly, you're sure to have problems with NNTP servers not
responding properly, or being too loaded to reply within reasonable
time. This is can lead to awkward problems, which can be helped
somewhat by setting
nntp-connection-timeout. This is an integer
that says how many seconds the
nntp backend should wait for a
connection before giving up. If it is
nil, which is the default,
no timeouts are done.
This hook is run as the last step when connecting to an NNTP
This function is used to connect to the remote system. Four pre-made
functions are supplied:
This is the default, and simply connects to some port or other on the
Does an `
rlogin' on the
remote system, and then does a `
telnet' to the NNTP server
Program used to log in on remote machines. The default is `
ssh' is a popular alternative.
This list will be used as the parameter list given to
User name on the remote system.
Does a `
telnet' to the remote system and then another `
to get to the NNTP server.
Command used to start
List of strings to be used as the switches to the
User name for log in on the remote system.
Password to use when logging in.
A list of strings executed as a command after logging in
Regexp matching the shell prompt on the remote machine. The default is
bash\\|\$ *\r?$\\|> *\r?'.
telnet session (client and server both)
will support the
ENVIRON option and not prompt for login name.
This works for Solaris
telnet, for instance.
Opens a connection to a server over a secure channel. To use this
you must have SSLay installed
ftp://ftp.psy.uq.oz.au/pub/Crypto/SSL', and you also need
ssl.el' (from the W3 distributeion, for instance). You then
define a server as follows:
;; Type `C-c C-c' after you've finished editing.
;; "snews" is port 563 and is predefined in our /etc/services
String to use as end-of-line marker when talking to the NNTP
server. This is `
\r\n' by default, but should be `
rlogin to talk to the server.
User name on the remote system when using the
The address of the remote system running the NNTP server.
Port number to connect to when using the
Set this to non-
nil if your select routine is buggy.
If the NNTP server does not support NOV, you could set this
nntp usually checks automatically whether NOV
can be used.
List of strings used as commands to fetch NOV lines from a
server. The default value of this variable is
nntp normally sends just one big request for NOV lines to
the server. The server responds with one huge list of lines. However,
if you have read articles 2-5000 in the group, and only want to read
article 1 and 5001, that means that
nntp will fetch 4999 NOV
lines that you will not need. This variable says how
big a gap between two consecutive articles is allowed to be before the
XOVER request is split into several request. Note that if your
network is fast, setting this variable to a really small number means
that fetching will probably be slower. If this variable is
nntp will never split requests. The default is 5.
A hook run before attempting to connect to an NNTP server.
If this variable is non-
nil, some noise will be made when a
server closes connection.
nntp will log all commands it sends to the
NNTP server (along with a timestep) in the `
buffer. This is useful if you are debugging a Gnus/NNTP connection
that doesn't seem to work.