xref: /aosp_15_r20/external/curl/docs/cmdline-opts/login-options.md (revision 6236dae45794135f37c4eb022389c904c8b0090d)
1*6236dae4SAndroid Build Coastguard Worker---
2*6236dae4SAndroid Build Coastguard Workerc: Copyright (C) Daniel Stenberg, <[email protected]>, et al.
3*6236dae4SAndroid Build Coastguard WorkerSPDX-License-Identifier: curl
4*6236dae4SAndroid Build Coastguard WorkerLong: login-options
5*6236dae4SAndroid Build Coastguard WorkerArg: <options>
6*6236dae4SAndroid Build Coastguard WorkerProtocols: IMAP LDAP POP3 SMTP
7*6236dae4SAndroid Build Coastguard WorkerHelp: Server login options
8*6236dae4SAndroid Build Coastguard WorkerAdded: 7.34.0
9*6236dae4SAndroid Build Coastguard WorkerCategory: imap pop3 smtp auth ldap
10*6236dae4SAndroid Build Coastguard WorkerMulti: single
11*6236dae4SAndroid Build Coastguard WorkerSee-also:
12*6236dae4SAndroid Build Coastguard Worker  - user
13*6236dae4SAndroid Build Coastguard WorkerExample:
14*6236dae4SAndroid Build Coastguard Worker  - --login-options 'AUTH=*' imap://example.com
15*6236dae4SAndroid Build Coastguard Worker---
16*6236dae4SAndroid Build Coastguard Worker
17*6236dae4SAndroid Build Coastguard Worker# `--login-options`
18*6236dae4SAndroid Build Coastguard Worker
19*6236dae4SAndroid Build Coastguard WorkerSpecify the login options to use during server authentication.
20*6236dae4SAndroid Build Coastguard Worker
21*6236dae4SAndroid Build Coastguard WorkerYou can use login options to specify protocol specific options that may be
22*6236dae4SAndroid Build Coastguard Workerused during authentication. At present only IMAP, POP3 and SMTP support login
23*6236dae4SAndroid Build Coastguard Workeroptions. For more information about login options please see RFC 2384,
24*6236dae4SAndroid Build Coastguard WorkerRFC 5092 and the IETF draft
25*6236dae4SAndroid Build Coastguard Workerhttps://datatracker.ietf.org/doc/html/draft-earhart-url-smtp-00
26*6236dae4SAndroid Build Coastguard Worker
27*6236dae4SAndroid Build Coastguard WorkerSince 8.2.0, IMAP supports the login option `AUTH=+LOGIN`. With this option,
28*6236dae4SAndroid Build Coastguard Workercurl uses the plain (not SASL) `LOGIN IMAP` command even if the server
29*6236dae4SAndroid Build Coastguard Workeradvertises SASL authentication. Care should be taken in using this option, as
30*6236dae4SAndroid Build Coastguard Workerit sends your password over the network in plain text. This does not work if
31*6236dae4SAndroid Build Coastguard Workerthe IMAP server disables the plain `LOGIN` (e.g. to prevent password
32*6236dae4SAndroid Build Coastguard Workersnooping).
33