This commit is contained in:
@@ -0,0 +1,69 @@
|
||||
.\" generated with Ronn-NG/v0.10.1
|
||||
.\" http://github.com/apjanke/ronn-ng/tree/0.10.1
|
||||
.TH "BUNDLE\-DOCTOR" "1" "April 2026" ""
|
||||
.SH "NAME"
|
||||
\fBbundle\-doctor\fR \- Checks the bundle for common problems
|
||||
.SH "SYNOPSIS"
|
||||
\fBbundle doctor [diagnose]\fR [\-\-quiet] [\-\-gemfile=GEMFILE] [\-\-ssl]
|
||||
.br
|
||||
\fBbundle doctor ssl\fR [\-\-host=HOST] [\-\-tls\-version=TLS\-VERSION] [\-\-verify\-mode=VERIFY\-MODE]
|
||||
.br
|
||||
\fBbundle doctor\fR help [COMMAND]
|
||||
.SH "DESCRIPTION"
|
||||
You can diagnose common Bundler problems with this command such as checking gem environment or SSL/TLS issue\.
|
||||
.SH "SUB\-COMMANDS"
|
||||
.SS "diagnose (default command)"
|
||||
Checks your Gemfile and gem environment for common problems\. If issues are detected, Bundler prints them and exits status 1\. Otherwise, Bundler prints a success message and exits status 0\.
|
||||
.P
|
||||
Examples of common problems caught include:
|
||||
.IP "\(bu" 4
|
||||
Invalid Bundler settings
|
||||
.IP "\(bu" 4
|
||||
Mismatched Ruby versions
|
||||
.IP "\(bu" 4
|
||||
Mismatched platforms
|
||||
.IP "\(bu" 4
|
||||
Uninstalled gems
|
||||
.IP "\(bu" 4
|
||||
Missing dependencies
|
||||
.IP "" 0
|
||||
.P
|
||||
\fBOPTIONS\fR
|
||||
.TP
|
||||
\fB\-\-quiet\fR
|
||||
Only output warnings and errors\.
|
||||
.TP
|
||||
\fB\-\-gemfile=GEMFILE\fR
|
||||
The location of the Gemfile(5) which Bundler should use\. This defaults to a Gemfile(5) in the current working directory\. In general, Bundler will assume that the location of the Gemfile(5) is also the project's root and will try to find \fBGemfile\.lock\fR and \fBvendor/cache\fR relative to this location\.
|
||||
.TP
|
||||
\fB\-\-ssl\fR
|
||||
Diagnose common SSL problems when connecting to https://rubygems\.org\.
|
||||
.IP
|
||||
This flag runs the \fBbundle doctor ssl\fR subcommand with default values underneath\.
|
||||
.SS "ssl"
|
||||
If you've experienced issues related to SSL certificates and/or TLS versions while connecting to https://rubygems\.org, this command can help troubleshoot common problems\. The diagnostic will perform a few checks such as:
|
||||
.IP "\(bu" 4
|
||||
Verify the Ruby OpenSSL version installed on your system\.
|
||||
.IP "\(bu" 4
|
||||
Check the OpenSSL library version used for compilation\.
|
||||
.IP "\(bu" 4
|
||||
Ensure CA certificates are correctly setup on your machine\.
|
||||
.IP "\(bu" 4
|
||||
Open a TLS connection and verify the outcome\.
|
||||
.IP "" 0
|
||||
.P
|
||||
\fBOPTIONS\fR
|
||||
.TP
|
||||
\fB\-\-host=HOST\fR
|
||||
Perform the diagnostic on HOST\. Defaults to \fBrubygems\.org\fR\.
|
||||
.TP
|
||||
\fB\-\-tls\-version=TLS\-VERSION\fR
|
||||
Specify the TLS version when opening the connection to HOST\.
|
||||
.IP
|
||||
Accepted values are: \fB1\.1\fR or \fB1\.2\fR\.
|
||||
.TP
|
||||
\fB\-\-verify\-mode=VERIFY\-MODE\fR
|
||||
Specify the TLS verify mode when opening the connection to HOST\. Defaults to \fBSSL_VERIFY_PEER\fR\.
|
||||
.IP
|
||||
Accepted values are: \fBCLIENT_ONCE\fR, \fBFAIL_IF_NO_PEER_CERT\fR, \fBNONE\fR, \fBPEER\fR\.
|
||||
|
||||
Reference in New Issue
Block a user