xref: /curl/docs/cmdline-opts/login-options.md (revision 2494b8dd)
1---
2c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
3SPDX-License-Identifier: curl
4Long: login-options
5Arg: <options>
6Protocols: IMAP LDAP POP3 SMTP
7Help: Server login options
8Added: 7.34.0
9Category: imap pop3 smtp auth
10Multi: single
11See-also:
12  - user
13Example:
14  - --login-options 'AUTH=*' imap://example.com
15---
16
17# `--login-options`
18
19Specify the login options to use during server authentication.
20
21You can use login options to specify protocol specific options that may be
22used during authentication. At present only IMAP, POP3 and SMTP support login
23options. For more information about login options please see RFC 2384,
24RFC 5092 and the IETF draft
25https://datatracker.ietf.org/doc/html/draft-earhart-url-smtp-00
26
27Since 8.2.0, IMAP supports the login option `AUTH=+LOGIN`. With this option,
28curl uses the plain (not SASL) `LOGIN IMAP` command even if the server
29advertises SASL authentication. Care should be taken in using this option, as
30it sends your password over the network in plain text. This does not work if
31the IMAP server disables the plain `LOGIN` (e.g. to prevent password
32snooping).
33