mirror of
https://github.com/curl/curl.git
synced 2025-01-12 13:55:11 +08:00
2494b8dd51
- switch all invidual files documenting command line options into .md, as the documentation is now markdown-looking. - made the parser treat 4-space indents as quotes - switch to building the curl.1 manpage using the "mainpage.idx" file, which lists the files to include to generate it, instead of using the previous page-footer/headers. Also, those files are now also .md ones, using the same format. I gave them underscore prefixes to make them sort separately: _NAME.md, _SYNOPSIS.md, _DESCRIPTION.md, _URL.md, _GLOBBING.md, _VARIABLES.md, _OUTPUT.md, _PROTOCOLS.md, _PROGRESS.md, _VERSION.md, _OPTIONS.md, _FILES.md, _ENVIRONMENT.md, _PROXYPREFIX.md, _EXITCODES.md, _BUGS.md, _AUTHORS.md, _WWW.md, _SEEALSO.md - updated test cases accordingly Closes #12751
39 lines
1.1 KiB
Markdown
39 lines
1.1 KiB
Markdown
---
|
|
c: Copyright (C) Daniel Stenberg, <daniel@haxx.se>, et al.
|
|
SPDX-License-Identifier: curl
|
|
Long: netrc
|
|
Short: n
|
|
Help: Must read .netrc for user name and password
|
|
Category: curl
|
|
Added: 4.6
|
|
Mutexed: netrc-file netrc-optional
|
|
Multi: boolean
|
|
See-also:
|
|
- netrc-file
|
|
- config
|
|
- user
|
|
Example:
|
|
- --netrc $URL
|
|
---
|
|
|
|
# `--netrc`
|
|
|
|
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.
|
|
|
|
A quick and simple example of how to setup a *.netrc* to allow curl to FTP to
|
|
the machine host.domain.com with user name 'myself' and password 'secret'
|
|
could look similar to:
|
|
|
|
machine host.domain.com
|
|
login myself
|
|
password secret
|