{"id":6922,"date":"2022-12-20T19:34:20","date_gmt":"2022-12-20T22:34:20","guid":{"rendered":"http:\/\/lode.uno\/linux-man\/index.php\/2022\/12\/20\/netssl-man3\/"},"modified":"2022-12-20T19:34:20","modified_gmt":"2022-12-20T22:34:20","slug":"netssl-man3","status":"publish","type":"post","link":"https:\/\/lode.uno\/linux-man\/2022\/12\/20\/netssl-man3\/","title":{"rendered":"Net::SSL (man3)"},"content":{"rendered":"<h1 align=\"center\">Net::SSL<\/h1>\n<p> <a href=\"#NAME\">NAME<\/a><br \/> <a href=\"#METHODS\">METHODS<\/a><br \/> <a href=\"#DIAGNOSTICS\">DIAGNOSTICS<\/a> <\/p>\n<hr>\n<h2>NAME <a name=\"NAME\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">Net::SSL \u2212 support for Secure Sockets Layer<\/p>\n<h2>METHODS <a name=\"METHODS\"><\/a> <\/h2>\n<table width=\"100%\" border=\"0\" rules=\"none\" frame=\"void\" cellspacing=\"0\" cellpadding=\"0\">\n<tr valign=\"top\" align=\"left\">\n<td width=\"11%\"><\/td>\n<td width=\"4%\">\n<p style=\"margin-top: 1em\">new<\/p>\n<\/td>\n<td width=\"2%\"><\/td>\n<td width=\"49%\">\n<p style=\"margin-top: 1em\">Creates a new &#8220;Net::SSL&#8221; object.<\/p>\n<\/td>\n<td width=\"34%\"> <\/td>\n<\/tr>\n<\/table>\n<p style=\"margin-left:11%;\">configure<\/p>\n<p style=\"margin-left:17%;\">Configures a &#8220;Net::SSL&#8221; socket for operation.<\/p>\n<p style=\"margin-left:11%;\">configure_certs<\/p>\n<p style=\"margin-left:17%;\">Sets up a certificate file to use for communicating with on the socket.<\/p>\n<p style=\"margin-left:11%;\">connect <br \/> die_with_error <br \/> get_cipher <br \/> get_lwp_object<\/p>\n<p style=\"margin-left:17%;\">Walks up the caller stack and looks for something blessed into the &#8220;LWP::UserAgent&#8221; namespace and returns it. Vaguely deprecated.<\/p>\n<p style=\"margin-left:11%;\">get_peer_certificate<\/p>\n<p style=\"margin-left:17%;\">Gets the peer certificate from the underlying &#8220;Crypt::SSLeay::Conn&#8221; object.<\/p>\n<p style=\"margin-left:11%;\">get_peer_verify <br \/> get_shared_ciphers <br \/> getchunk<\/p>\n<p style=\"margin-left:17%;\">Attempts to read up to 32KiB of data from the socket. Returns &#8220;undef&#8221; if nothing was read, otherwise returns the data as a scalar.<\/p>\n<p style=\"margin-left:11%;\">pending<\/p>\n<p style=\"margin-left:17%;\">Provides access to OpenSSL\u2019s &#8220;pending&#8221; attribute on the <small>SSL<\/small> connection object.<\/p>\n<p style=\"margin-left:11%;\">getline<\/p>\n<p style=\"margin-left:17%;\">Reads one character at a time until a newline is encountered, and returns the line, including the newline. Grossly inefficient.<\/p>\n<p style=\"margin-left:11%;\">print<\/p>\n<p style=\"margin-left:17%;\">Concatenates the input parameters and writes them to the socket. Does not honour $, nor $\/. Returns the number of bytes written.<\/p>\n<p style=\"margin-left:11%;\">printf<\/p>\n<p style=\"margin-left:17%;\">Performs a &#8220;sprintf&#8221; of the input parameters (thus, the first parameter must be the format), and writes the result to the socket. Returns the number of bytes written.<\/p>\n<p style=\"margin-left:11%;\">proxy<\/p>\n<p style=\"margin-left:17%;\">Returns the hostname of an https proxy server, as specified by the &#8220;HTTPS_PROXY&#8221; environment variable.<\/p>\n<p style=\"margin-left:11%;\">proxy_connect_helper<\/p>\n<p style=\"margin-left:17%;\">Helps set up a connection through a proxy.<\/p>\n<p style=\"margin-left:11%;\">read<\/p>\n<p style=\"margin-left:17%;\">Performs a read on the socket and returns the result.<\/p>\n<p style=\"margin-left:11%;\">ssl_context <br \/> sysread<\/p>\n<p style=\"margin-left:17%;\">Is an alias of &#8220;read&#8221;.<\/p>\n<p style=\"margin-left:11%;\">timeout<\/p>\n<p style=\"margin-left:17%;\">Returns the timeout value of the socket as defined by the implementing class or 60 seconds by default.<\/p>\n<p style=\"margin-left:11%;\">blocking<\/p>\n<p style=\"margin-left:17%;\">Returns a boolean indicating whether the underlying socket is in blocking mode. By default, Net::SSL sockets are in blocking mode.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">$sock\u2212>blocking(0); # set to non\u2212blocking mode<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">This method simply calls the underlying &#8220;blocking&#8221; method of the IO::Socket object.<\/p>\n<p style=\"margin-left:11%;\">write<\/p>\n<p style=\"margin-left:17%;\">Writes the parameters passed in (thus, a list) to the socket. Returns the number of bytes written.<\/p>\n<p style=\"margin-left:11%;\">syswrite<\/p>\n<p style=\"margin-left:17%;\">Is an alias of &#8220;write&#8221;.<\/p>\n<p style=\"margin-left:11%;\">accept<\/p>\n<p style=\"margin-left:17%;\">Not yet implemented. Will die if called.<\/p>\n<p style=\"margin-left:11%;\">getc<\/p>\n<p style=\"margin-left:17%;\">Not yet implemented. Will die if called.<\/p>\n<p style=\"margin-left:11%;\">getlines<\/p>\n<p style=\"margin-left:17%;\">Not yet implemented. Will die if called.<\/p>\n<p style=\"margin-left:11%;\">ungetc<\/p>\n<p style=\"margin-left:17%;\">Not yet implemented. Will die if called.<\/p>\n<p style=\"margin-left:11%;\">send_useragent_to_proxy<\/p>\n<p style=\"margin-left:17%;\">By default (as of version 2.80 of &#8220;Net::SSL&#8221; in the 0.54 distribution of Crypt::SSLeay), the user agent string is no longer sent to the proxy (but will continue to be sent to the remote host).<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">The previous behaviour was of marginal benefit, and could cause fatal errors in certain scenarios (see <small>CPAN<\/small> bug #4759) and so no longer happens by default.<\/p>\n<p style=\"margin-left:17%; margin-top: 1em\">To reinstate the old behaviour, call &#8220;Net::SSL::send_useragent_to_proxy&#8221; with a true value (usually 1).<\/p>\n<h2>DIAGNOSTICS <a name=\"DIAGNOSTICS\"><\/a> <\/h2>\n<p style=\"margin-left:11%; margin-top: 1em\">&#8220;no port given for proxy server <proxy>&#8220;<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">A proxy was specified for configuring a socket, but no port number was given. Ensure that the proxy is specified as a host:port pair, such as &#8220;proxy.example.com:8086&#8221;.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">&#8220;configure certs failed: <contents of $@>; <contents of $!>&#8221; <br \/> &#8220;proxy connect failed: <contents of $@>; <contents of $!>&#8221; <br \/> &#8220;Connect failed: <contents of $@>; <contents of $!>&#8220;<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\">During <b>connect()<\/b>.<\/p>\n<p style=\"margin-left:11%; margin-top: 1em\"><b><small>SEE ALSO<\/small><\/b> <br \/> IO::Socket::INET<\/p>\n<p style=\"margin-left:17%;\">&#8220;Net::SSL&#8221; is implemented by subclassing &#8220;IO::Socket::INET&#8221;, hence methods not specifically overridden are defined by that package.<\/p>\n<p style=\"margin-left:11%;\">Net::SSLeay<\/p>\n<p style=\"margin-left:17%;\">A package that provides a Perl-level interface to the &#8220;openssl&#8221; secure sockets layer library.<\/p>\n<hr>\n","protected":false},"excerpt":{"rendered":"<p>  Net::SSL \u2212 support for Secure Sockets Layer <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[1],"tags":[3007,3279],"class_list":["post-6922","post","type-post","status-publish","format-standard","hentry","category-sin-categoria","tag-man3","tag-netssl"],"gutentor_comment":0,"_links":{"self":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6922","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/comments?post=6922"}],"version-history":[{"count":0,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/posts\/6922\/revisions"}],"wp:attachment":[{"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/media?parent=6922"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/categories?post=6922"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/lode.uno\/linux-man\/wp-json\/wp\/v2\/tags?post=6922"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}