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
|
|
|
---
|
2021-03-22 23:50:57 +08:00
|
|
|
Makes curl scan the *.netrc* (*_netrc* on Windows) file in the user's home
|
|
|
|
|
directory for login name and password. This is typically used for FTP on
|
2016-11-16 21:20:36 +08:00
|
|
|
Unix. If used with HTTP, curl will enable user authentication. See
|
2021-07-20 13:06:56 +08:00
|
|
|
*netrc(5)* and *ftp(1)* for details on the file format. Curl will not
|
2021-10-31 23:34:44 +08:00
|
|
|
complain if that file does not have the right permissions (it should be
|
2021-07-20 13:06:56 +08:00
|
|
|
neither world- nor group-readable). The environment variable "HOME" is used
|
|
|
|
|
to find the home directory.
|
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
|
