Python Ping

admin
  1. How To Make A Pinger In Python
  2. Python Ping Command

Pastebin.com is the number one paste tool since 2002. Pastebin is a website where you can store text online for a set period of time. It does not make sense in playbooks, but it is useful from /usr/bin/ansible to verify the ability to login and that a usable Python is configured. This is NOT ICMP ping, this is just a trivial test module that requires Python on the remote-node. For Windows targets, use the ansible.windows.winping module instead. How To Create a Ping Verification Script in Python Part 1Check Out MY GitHub: this video we quick and easy ping script that you can.

Source code:Lib/ftplib.py

This module defines the class FTP and a few related items. TheFTP class implements the client side of the FTP protocol. You can usethis to write Python programs that perform a variety of automated FTP jobs, suchas mirroring other FTP servers. It is also used by the moduleurllib.request to handle URLs that use FTP. For more information on FTP(File Transfer Protocol), see Internet RFC 959.

The default encoding is UTF-8, following RFC 2640.

Here’s a sample session using the ftplib module:

The module defines the following items:

class ftplib.FTP(host=', user=', passwd=', acct=', timeout=None, source_address=None, *, encoding='utf-8')

Return a new instance of the FTP class. When host is given, themethod call connect(host) is made. When user is given, additionallythe method call login(user,passwd,acct) is made (where passwd andacct default to the empty string when not given). The optional timeoutparameter specifies a timeout in seconds for blocking operations like theconnection attempt (if is not specified, the global default timeout settingwill be used). source_address is a 2-tuple (host,port) for the socketto bind to as its source address before connecting. The encoding parameterspecifies the encoding for directories and filenames.

The FTP class supports the with statement, e.g.:

Changed in version 3.2: Support for the with statement was added.

Changed in version 3.3: source_address parameter was added.

Changed in version 3.9: If the timeout parameter is set to be zero, it will raise aValueError to prevent the creation of a non-blocking socket.The encoding parameter was added, and the default was changed fromLatin-1 to UTF-8 to follow RFC 2640.

class ftplib.FTP_TLS(host=', user=', passwd=', acct=', keyfile=None, certfile=None, context=None, timeout=None, source_address=None, *, encoding='utf-8')

A FTP subclass which adds TLS support to FTP as described inRFC 4217.Connect as usual to port 21 implicitly securing the FTP control connectionbefore authenticating. Securing the data connection requires the user toexplicitly ask for it by calling the prot_p() method. contextis a ssl.SSLContext object which allows bundling SSL configurationoptions, certificates and private keys into a single (potentiallylong-lived) structure. Please read Security considerations for best practices.

keyfile and certfile are a legacy alternative to context – theycan point to PEM-formatted private key and certificate chain files(respectively) for the SSL connection.

Changed in version 3.3: source_address parameter was added.

Changed in version 3.4: The class now supports hostname check withssl.SSLContext.check_hostname and Server Name Indication (seessl.HAS_SNI).

Deprecated since version 3.6: keyfile and certfile are deprecated in favor of context.Please use ssl.SSLContext.load_cert_chain() instead, or letssl.create_default_context() select the system’s trusted CAcertificates for you.

Changed in version 3.9: If the timeout parameter is set to be zero, it will raise aValueError to prevent the creation of a non-blocking socket.The encoding parameter was added, and the default was changed fromLatin-1 to UTF-8 to follow RFC 2640.

Here’s a sample session using the FTP_TLS class:

exception ftplib.error_reply

Exception raised when an unexpected reply is received from the server.

exception ftplib.error_temp

Exception raised when an error code signifying a temporary error (responsecodes in the range 400–499) is received.

exception ftplib.error_perm

Exception raised when an error code signifying a permanent error (responsecodes in the range 500–599) is received.

exception ftplib.error_proto

Exception raised when a reply is received from the server that does not fitthe response specifications of the File Transfer Protocol, i.e. begin with adigit in the range 1–5.

ftplib.all_errors

The set of all exceptions (as a tuple) that methods of FTPinstances may raise as a result of problems with the FTP connection (asopposed to programming errors made by the caller). This set includes thefour exceptions listed above as well as OSError and EOFError.

See also

Module netrc

Parser for the .netrc file format. The file .netrc istypically used by FTP clients to load user authentication informationbefore prompting the user.

FTP Objects¶

Several methods are available in two flavors: one for handling text files andanother for binary files. These are named for the command which is usedfollowed by lines for the text version or binary for the binary version.

FTP instances have the following methods:

FTP.set_debuglevel(level)

Set the instance’s debugging level. This controls the amount of debuggingoutput printed. The default, 0, produces no debugging output. A value of1 produces a moderate amount of debugging output, generally a single lineper request. A value of 2 or higher produces the maximum amount ofdebugging output, logging each line sent and received on the control connection.

FTP.connect(host=', port=0, timeout=None, source_address=None)

Connect to the given host and port. The default port number is 21, asspecified by the FTP protocol specification. It is rarely needed to specify adifferent port number. This function should be called only once for eachinstance; it should not be called at all if a host was given when the instancewas created. All other methods can only be used after a connection has beenmade.The optional timeout parameter specifies a timeout in seconds for theconnection attempt. If no timeout is passed, the global default timeoutsetting will be used.source_address is a 2-tuple (host,port) for the socket to bind to asits source address before connecting.

Raises an auditing eventftplib.connect with arguments self, host, port.

Changed in version 3.3: source_address parameter was added.

FTP.getwelcome()

Return the welcome message sent by the server in reply to the initialconnection. (This message sometimes contains disclaimers or help informationthat may be relevant to the user.)

FTP.login(user='anonymous', passwd=', acct=')

Log in as the given user. The passwd and acct parameters are optional anddefault to the empty string. If no user is specified, it defaults to'anonymous'. If user is 'anonymous', the default passwd is'[email protected]'. This function should be called only once for each instance,after a connection has been established; it should not be called at all if ahost and user were given when the instance was created. Most FTP commands areonly allowed after the client has logged in. The acct parameter supplies“accounting information”; few systems implement this.

FTP.abort()

Abort a file transfer that is in progress. Using this does not always work, butit’s worth a try.

FTP.sendcmd(cmd)

Send a simple command string to the server and return the response string.

Raises an auditing eventftplib.sendcmd with arguments self, cmd.

FTP.voidcmd(cmd)

Send a simple command string to the server and handle the response. Returnnothing if a response code corresponding to success (codes in the range200–299) is received. Raise error_reply otherwise.

Raises an auditing eventftplib.sendcmd with arguments self, cmd.

FTP.retrbinary(cmd, callback, blocksize=8192, rest=None)

Retrieve a file in binary transfer mode. cmd should be an appropriateRETR command: 'RETRfilename'. The callback function is called foreach block of data received, with a single bytes argument giving the datablock. The optional blocksize argument specifies the maximum chunk size toread on the low-level socket object created to do the actual transfer (whichwill also be the largest size of the data blocks passed to callback). Areasonable default is chosen. rest means the same thing as in thetransfercmd() method.

FTP.retrlines(cmd, callback=None)

Retrieve a file or directory listing in the encoding specified by theencoding parameter at initialization.cmd should be an appropriate RETR command (see retrbinary()) ora command such as LIST or NLST (usually just the string 'LIST').LIST retrieves a list of files and information about those files.NLST retrieves a list of file names.The callback function is called for each line with a string argumentcontaining the line with the trailing CRLF stripped. The default callbackprints the line to sys.stdout.

FTP.set_pasv(val)
Ping

Enable “passive” mode if val is true, otherwise disable passive mode.Passive mode is on by default.

Python ping server
FTP.storbinary(cmd, fp, blocksize=8192, callback=None, rest=None)

Store a file in binary transfer mode. cmd should be an appropriateSTOR command: 'STORfilename'. fp is a file object(opened in binary mode) which is read until EOF using its read()method in blocks of size blocksize to provide the data to be stored.The blocksize argument defaults to 8192. callback is an optional singleparameter callable that is called on each block of data after it is sent.rest means the same thing as in the transfercmd() method.

FTP.storlines(cmd, fp, callback=None)

Store a file in line mode. cmd should be an appropriateSTOR command (see storbinary()). Lines are read until EOF from thefile objectfp (opened in binary mode) using its readline()method to provide the data to be stored. callback is an optional singleparameter callable that is called on each line after it is sent.

FTP.transfercmd(cmd, rest=None)

Initiate a transfer over the data connection. If the transfer is active, send anEPRT or PORT command and the transfer command specified by cmd, andaccept the connection. If the server is passive, send an EPSV or PASVcommand, connect to it, and start the transfer command. Either way, return thesocket for the connection.

If optional rest is given, a REST command is sent to the server, passingrest as an argument. rest is usually a byte offset into the requested file,telling the server to restart sending the file’s bytes at the requested offset,skipping over the initial bytes. Note however that the transfercmd()method converts rest to a string with the encoding parameter specifiedat initialization, but no check is performed on the string’s contents. If theserver does not recognize the REST command, an error_reply exceptionwill be raised. If this happens, simply call transfercmd() without arest argument.

FTP.ntransfercmd(cmd, rest=None)

Like transfercmd(), but returns a tuple of the data connection and theexpected size of the data. If the expected size could not be computed, Nonewill be returned as the expected size. cmd and rest means the same thing asin transfercmd().

FTP.mlsd(path=', facts=[])

List a directory in a standardized format by using MLSD command(RFC 3659). If path is omitted the current directory is assumed.facts is a list of strings representing the type of information desired(e.g. ['type','size','perm']). Return a generator object yielding atuple of two elements for every file found in path. First element is thefile name, the second one is a dictionary containing facts about the filename. Content of this dictionary might be limited by the facts argumentbut server is not guaranteed to return all requested facts.

New in version 3.3.

Speedtest macbook

FTP.nlst(argument[, ..])

Return a list of file names as returned by the NLST command. Theoptional argument is a directory to list (default is the current serverdirectory). Multiple arguments can be used to pass non-standard options tothe NLST command.

Note

If your server supports the command, mlsd() offers a better API.

FTP.dir(argument[, ..])

Produce a directory listing as returned by the LIST command, printing it tostandard output. The optional argument is a directory to list (default is thecurrent server directory). Multiple arguments can be used to pass non-standardoptions to the LIST command. If the last argument is a function, it is usedas a callback function as for retrlines(); the default prints tosys.stdout. This method returns None.

Note

How To Make A Pinger In Python

If your server supports the command, mlsd() offers a better API.

FTP.rename(fromname, toname)

Rename file fromname on the server to toname.

FTP.delete(filename)

Remove the file named filename from the server. If successful, returns thetext of the response, otherwise raises error_perm on permission errors orerror_reply on other errors.

FTP.cwd(pathname)

Set the current directory on the server.

FTP.mkd(pathname)

Create a new directory on the server.

FTP.pwd()

Return the pathname of the current directory on the server.

FTP.rmd(dirname)

Remove the directory named dirname on the server.

FTP.size(filename)

Request the size of the file named filename on the server. On success, thesize of the file is returned as an integer, otherwise None is returned.Note that the SIZE command is not standardized, but is supported by manycommon server implementations.

FTP.quit()

Send a QUIT command to the server and close the connection. This is the“polite” way to close a connection, but it may raise an exception if the serverresponds with an error to the QUIT command. This implies a call to theclose() method which renders the FTP instance useless forsubsequent calls (see below).

FTP.close()

Close the connection unilaterally. This should not be applied to an alreadyclosed connection such as after a successful call to quit().After this call the FTP instance should not be used any more (aftera call to close() or quit() you cannot reopen theconnection by issuing another login() method).

FTP_TLS Objects¶

FTP_TLS class inherits from FTP, defining these additional objects:

FTP_TLS.ssl_version

The SSL version to use (defaults to ssl.PROTOCOL_SSLv23).

FTP_TLS.auth()

Set up a secure control connection by using TLS or SSL, depending on whatis specified in the ssl_version attribute.

Changed in version 3.4: The method now supports hostname check withssl.SSLContext.check_hostname and Server Name Indication (seessl.HAS_SNI).

FTP_TLS.ccc()

Revert control channel back to plaintext. This can be useful to takeadvantage of firewalls that know how to handle NAT with non-secure FTPwithout opening fixed ports.

FTP_TLS.prot_p()

Set up secure data connection.

FTP_TLS.prot_c()

Set up clear text data connection.

Note

This module is part of ansible-base and included in all Ansibleinstallations. In most cases, you can use the short module nameping even without specifying the collections: keyword.Despite that, we recommend you use the FQCN for easy linking to the moduledocumentation and to avoid conflicting with other collections that may havethe same module name.

  • A trivial test module, this module always returns pong on successful contact. It does not make sense in playbooks, but it is useful from /usr/bin/ansible to verify the ability to login and that a usable Python is configured.

  • This is NOT ICMP ping, this is just a trivial test module that requires Python on the remote-node.

  • For Windows targets, use the ansible.windows.win_ping module instead.

  • For Network targets, use the ansible.netcommon.net_ping module instead.

ParameterChoices/DefaultsComments
data
string
Default:
Data to return for the ping return value.
If this parameter is set to crash, the module will cause an exception.

See also

ansible.netcommon.net_ping

The official documentation on the ansible.netcommon.net_ping module.

ansible.windows.win_ping

The official documentation on the ansible.windows.win_ping module.

Common return values are documented here, the following are the fields unique to this module:

KeyReturnedDescription
ping
string
success
Sample:

Authors¶

Python Ping Command

  • Ansible Core Team

  • Michael DeHaan