Skip to content

Latest commit

 

History

History
131 lines (93 loc) · 6.81 KB

CHANGELOG.md

File metadata and controls

131 lines (93 loc) · 6.81 KB
Raw

Changelog

1.6.1 - 2021-07-29

  • Remove print() statement that was used during testing

1.6.0 - 2021-07-28

  • Dropped support for Python 2.7 and 3.5
  • Add performance improvement on reads with large files
  • Added the require_signing kwarg to smbclient.register_session() to allow the caller to control whether signing is required on the connection or not
  • Fix OverflowError when handling FILETIME values beyond the year 9999 - caps the value to 9999-12-31 due to a Python limitation
  • Fix up credit charge calculation which causes a STATUS_INVALID_PARAMETER response for certain read/write lengths
  • Ensure responses with a failure are cleaned up from the outstanding request table to avoid memory leaks

1.5.1 - 2021-05-08

  • Unified DFS path handling when using any API that uses a transaction to open the file
    • This includes smbclient.rename and smbclient.replace
  • Fixed up smbclient.rename to work with directories
  • smbclient.scandir will continue to use the connection cache when getting stat information of a dir entry
  • smbclient.shutil.rmtree will continue to use the connection cache when removing child entries

1.5.0 - 2021-03-25

  • Added smbprotocol.exceptions.SMBConnectionClosed that is raised when trying to send or receive data on a connection that has been closed
  • Added smbprotocol.exceptions.WrongPassword that is raised when some servers indicate the password is not correct or the account is locked out
  • Do not attempt to reuse any cached connections that have been closed in smbclient
  • Added a lock when writing to the socket, only 1 thread can write a message at a single point in time
  • Revamped the SMB receiver code to simplify the logic and make it more durable
    • Removed the TCP recv thread for each connection, now each connection uses just 1 thread instead of 2
    • Be more defensive when reading data from a socket to ensure we get all the data we require
    • Handled server side FIN packets that close the connection unexpectedly, any requests waiting for a response will raise SMBConnectionClosed

1.4.0 - 2021-02-02

  • Fixed up secure negotiation logic when connecting to older SMB dialects
  • Will attempt to perform secure negotiation even on older dialects that may not implement it properly
  • Added ClientConfig option require_secure_negotiate to globally turn off secure negotiation if the client wishes
  • Fix explicit ntlm or kerberos authentication when the server response with the initial SPNEGO mech list token

1.3.0 - 2021-01-23

  • Changed initial credit request from 256 to 64 when creating the SMB session
    • This is done to avoid overloading the SMB server
    • If smbclient requires more credits to perform an operation it will request it automatically
  • Improve credit handling when reading and writing large amounts of data to reduce the number of requests being made
  • Fixed up write() in smbclient.open_file() to be able to write bytes greater than the max_write_size
  • Fixed issue when receiving an unknown NtStatus error code from the server
  • Added PipeBusy exception for STATUS_PIPE_NOT_AVAILABLE 0xC00000AD error responses
  • Fix credit granting calculation when receiving a compound response
    • Original logic granted len(responses) - 1 credits than what the server actually given causing errors when the client ran out of credits without it knowing
  • Added auth_protocol to Session, ClientConfig, and register_session() to control what authentication protocol is used
    • This can be negotiate (default), kerberos, or ntlm where negotiate selects kerberos or ntlm depending on what's available

1.2.0 - 2020-09-22

  • Added experimental support for DFS shares when using smbclient function
  • Added smbclient.ClientConfig() to set global default options on new connections
  • Moved the SMB Header structures to smbprotocol.header
  • Added null_terminated option for a TextField value
  • Fix broken pipe errors that occur on long running connections by sending a echo request for each connection session every 10 minutes

1.1.0 - 2020-08-14

  • Speed up logging statements for large messages like a read and write message
  • Changed authentication dep to pyspnego that handles all the authentication work
  • Fixed up authentication against hosts that don't present the initial GSSAPI token like Azure File Storage
  • Added specific exception types for every NtStatus value to make it easier to catch only specific exceptions
  • Added the following exceptions to the list of known exception codes
    • STATUS_NETWORK_NAME_DELETED
    • STATUS_NOT_FOUND
    • STATUS_PATH_NOT_COVERED
    • STATUS_DFS_UNAVAILABLE
    • STATUS_SERVER_UNAVAILABLE
  • Fix session key generation when creating a new session from an existing connection object

1.0.1 - 2019-12-12

  • Fix issue when reading a large file that exceeds 65KB and raises STATUS_END_OF_FILE.
  • Fix issue where listdir, scandir, walk would only enumerate a subset of entries in a directories with lots of sub files/folders

1.0.0 - 2019-11-30

  • Dropped support for Python 2.6 and Python 3.4
  • Added the smbclient package that provides a higher level API for interactive with SMB servers
  • Deprecated smbprotocol.query_info in favour of smbprotocol.file_info, query_info will be removed in the next major release
  • Add automatic symlink resolver when a symlink is in the path being opened
  • Fix issue when trying to connect to host with IPv6 address
  • Fix response parsing for SMB2 Create Response Lease V1 and V2
  • Added the ability to set the Oplock level when opening a file
  • Revamped the socket listener and message processor to run in a separate thread for faster message resolving
  • Added the FileSystemWatcher in change_notify.py to provider a way to watch for changes on the SMB filesystem
  • Added the .cancel() method onto a Request to cancel an SMB request on the server

0.2.0 - 2019-09-19

  • Fix issue where timeout was not being applied to the new connection
  • Fix various deprecated regex escape patterns
  • Added support for Windows Kerberos and implicit credential support through the optional extra library pywin32
  • Simplified the fallback NTLM context object

0.1.1 - 2018-09-14

  • Fix initial negotiate message not setting connection timeout value
  • Fix endless loop when running a compound message that failed

0.1.0 - 2018-03-07

Initial release of smbprotocol, it contains the following features

  • Support for Dialect 2.0.2 to 3.1.1
  • Supports message encryption and signing
  • Works with both NTLM and Kerberos auth (latter requiring a non-windows library)
  • Open files, directories and pipes
  • Open command with create_contexts to set extra attributes on an open
  • Read/Write the files
  • Send IOCTL commands
  • Sending of multiple messages in one packet (compounding)