2023-01-02 20:51:48 +08:00
|
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
2022-06-14 06:12:03 +08:00
|
|
|
SPDX-License-Identifier: curl
|
2016-11-16 21:20:36 +08:00
|
|
|
Long: netrc
|
|
|
|
|
Short: n
|
|
|
|
|
Help: Must read .netrc for user name and password
|
2020-07-13 20:15:04 +08:00
|
|
|
Category: curl
|
2021-08-31 22:37:14 +08:00
|
|
|
Example: --netrc $URL
|
2021-09-28 17:50:07 +08:00
|
|
|
Added: 4.6
|
2021-11-15 22:58:20 +08:00
|
|
|
See-also: netrc-file config user
|
2022-11-14 06:14:38 +08:00
|
|
|
Mutexed: netrc-file netrc-optional
|
2022-10-18 16:39:43 +08:00
|
|
|
Multi: boolean
|
2016-11-16 21:20:36 +08:00
|
|
|
---
|
2023-09-21 06:59:45 +08:00
|
|
|
Makes curl scan the *.netrc* file in the user's home directory for login name
|
|
|
|
|
and password. This is typically used for FTP on Unix. If used with HTTP, curl
|
|
|
|
|
enables user authentication. See *netrc(5)* and *ftp(1)* for details on the
|
|
|
|
|
file format. Curl does not complain if that file does not have the right
|
|
|
|
|
permissions (it should be neither world- nor group-readable). The environment
|
|
|
|
|
variable "HOME" is used to find the home directory.
|
|
|
|
|
|
|
|
|
|
On Windows two filenames in the home directory are checked: *.netrc* and
|
|
|
|
|
*_netrc*, preferring the former. Older versions on Windows checked for *_netrc*
|
|
|
|
|
only.
|
2016-11-16 21:20:36 +08:00
|
|
|
|
2021-11-01 20:43:11 +08:00
|
|
|
A quick and simple example of how to setup a *.netrc* to allow curl to FTP to
|
2022-08-23 19:42:49 +08:00
|
|
|
the machine host.domain.com with user name 'myself' and password 'secret'
|
2021-11-16 21:58:36 +08:00
|
|
|
could look similar to:
|
2016-11-16 21:20:36 +08:00
|
|
|
|
2021-11-16 21:58:36 +08:00
|
|
|
machine host.domain.com
|
|
|
|
|
login myself
|
2022-07-06 15:45:07 +08:00
|
|
|
password secret
|
