Changelogs » Pysmb

PyUp Safety actively tracks 266,461 Python packages for vulnerabilities and notifies you when to upgrade.



  - Fix bug in filename encoding which leads to failure for file retrieval and upload operations (170 171).
  - Improve resetFileAttributes() method in SMBConnection class to allow the
  new attribute to be specified in the reset operation (172).


  - Remove dependency on pycrypto as it is no longer under active maintenance


  - Fix bug in session key generation during session negotiation (166)
  - Fix bug in SMB message signing which leads to operation failures with Samba services.


  - Improve SMB URL handlers to support specifying server's machine name and IP
  address. (162)
  - Improvements to documentation on SMB URLs (160)


  - Fix bug in deleteFiles() method which can fail for certain search patterns.


  - Add new parameter, delete_matching_folders, to deleteFiles() method to
  support deletion of child folders that match the search pattern.


  - Fix unhandled exception for short NBNS queries 149
  - Fix wildcard file deletion with servers on SMB2 protocol 33


  - SharedFile instances returned from the listPath() method now has a new
  file_id attribute which represents the file reference number given by the SMB server.


  - Remove support for SMB-2.1 dialect as it seems to have issues with Windows 2008 R2


  - Prevents OperationError from being raised when listPath() operation does not
  return any matching file results.
  - SMBConnection is now a context manager 122.


  - Fix buggy support for search parameter in listPath() method. Add
  SMB_FILE_ATTRIBUTE_INCL_NORMAL bit constant to include 'normal' files with
  other file types in the returned result. From now on, pysmb defines a 'normal' file
  as a file entry that is not read-only, not hidden, not system, not archive and
  not a directory; it ignores other attributes like compression, indexed, sparse,
  temporary and encryption. listPath() method will now include 'normal' files
  using the default search parameter.
  - Add isNormal property to SharedFile class to support test if the file is a
  'normal' file (according to pysmb definition of 'normal' file).


  - Improve listPath implementation for SMB1
  - Support for STATUS_PENDING responses across all SMB2 operations.


  - Fix bug in listShares() method which fails when the remote server has many shares.
  - Improve echo() method to test and fail if the provided data to echo is not a bytes object.
  - Fix bug in listPath() method where the path to query is not properly terminated.


  - Fix bug in getAttributes() method which should return only the filename
  instead of the entire path for the filename property for the return result.


  - Fix bug where timestamp values for SMB1 getAttributes() response are not
  converted properly from FILETIME to epoch time values.


  - Add getSecurity() method to support security descriptors query via SMB2
  - Improve retrieveFile() and retrieveFileFromOffset() methods to allow file
  retrievals over SMB2 even when the file is being locked on the server.
  - Silently discards NMB SESSION_KEEPALIVE packets instead of raising warnings.
  - SMB sessionID will be sent in ECHO requests to conform to SMB2 specs.
  - Fix type errors for MD4 functions in python3.


  - Ignore STATUS_PENDING during delete and file store operations


  - Rollback fixes to NTLMv2 response algorithm in pysmb 1.1.17. The fixes
  fail to work with some servers.
  - Add missing errno imports in
  - Fix UnboundLocalError raised when using type() in


  - Fix crashes in directory listing with keyerror 'support_dfs'
  - Fix bugs in NTLMv2 response algorithm.
  - Fix bugs where client domain is not included as part of the session negotiation.


  - Fix typo errors in authentication error messages
  - Improve share listings on SMB2 protocol by ignoring interim STATUS_PENDING responses.


  - Add new parameter to SMBConnection's storeFileFromOffset method to determine
  whether the remote file is to be truncated before writing.


  - Add support for DFS shares in listPath()
  - Bug fix for python3's _listPath_SMB2 implementation


  - Add missing methods and improve compatibility with python3
  - Fix bug in SMB2 rename implementation which fails to rename directory


  - Fix syntax error for python3 NBNSProtocol implementation
  - Fix bug in SMB1 implementation which results in access denied errors with Samba 3.0


  - Add support for unicode characters in domain, username and password.
  - Add storeFileFromOffset method to SMB API
  - Fix bug in getAttributes implementation for SMB1
  - Fix bug for NMB which uses broadcast flag for unicast queries
  - Update the Tree Connect Andx request implementation to MS-SMB extensions


  - Add getAttributes() method to SMBConnection and SMBProtocolFactory class
  - Add isReadOnly property to SharedFile class


  - Add support for domains in smb:// URLs
  - Fix a bug which fails to test for the correct GSS security provider OID values


  - Fix a bug in storeFile() method when the destination file is not overwritten if
  it exists in SMB1 communication
  - Fix a SMB1 authentication problem when extended negotation is not carried out
  because the remote server has specified its support for extended security in the
  payload, instead of in the message flags2.


  - Improve listShares() function which can fail with the listing response is
  separated into multiple SMB packets for large number of shares.
  - Fix bug in python3 implementation where session connection can fail when
  remote server supports message signing.


  - Fix bug where the status of the SMB_COM_NEGOTIATE reply is not checked for error
  before allowing further processing.


  - Adds support for Direct hosting of SMB over TCP/IP (TCP port: 445)


  - Improve query performance for query IP addresses for NetBIOS names in
  - Fix bugs in SMBConnection when sending large data packets can result in


  - Fix bug which results in endless loop in SMBConnection when remote CIFS
  server closes the connection.


  - Improve queryIPForName() in nmb.NetBIOS and nmb.NBNSProtocol class to
  return only server machine name and ignore workgroup names.


  - Adds support for Python3. Noted that the Python3 SMB/NMB protocol implementations
  for Twisted are not well-tested as Twisted (as of v12.1) is not Python3 ready yet.
  - Adds support for retrieving list of shadow copies (also known as
  "previous versions" in Windows). Note that not all Windows editions support shadow


  - Adds SMB2 protocol implementation with signing for outgoing SMB2 messages.
  pysmb will utilize SMB2 protocol with servers that support SMB2
  (eg. Windows Vista, Windows 7 and Samba 3).
  If the remote server does not support SMB2, pysmb will fall back automatically
  to using SMB1 protocol.


  - Add supports for SMB message signing. pysmb will sign all SMB messages from
  the CIFS client to the server, but it does not verify the signatures of the
  SMB messages from the server.


  - Adds support for "smb://" URL in urllib2 python packages to retrieve or upload
  files from/to remote CIFS servers.
  - Improve documentation


  - Fix a crash in SMB._storFile() method which occurs when the remote CIFS server
  utilizes a max raw size larger than 65535 bytes. The bug was discovered with
  Windows 7 Pro SP1.
  - Fix a bug in SMB._listPath() method where the files/folders time information are
  not properly converted to Epoch time.
  - Add NBNSProtocol.queryIPForName() and NetBIOS.queryIPForName() methods to
  query for a machine's NetBIOS name at the given IP address.
  - Add SMBProtocol.retrieveFileFromOffset() and SMBConnection.retrieveFileFromOffset()
  methods for a finer control of file retrieval operation with read offset and write


  - Fix a bug in SMB._handleSessionChallenge() method in where the domain attribute
  was not used to generate the corresponding NTLM authentication packets, resulting in
  the default WORKGROUP domain for used for all subsequent authentications.


  - Fixes a bug in listPath() method which causes directory listing for
  sub-directories to return an empty list.
  - Fixes an incorrect implementation of the TRANS2_FIND_FIRST2 and
  TRANS2_FIND_NEXT2 request/response handling which causes directory listing
  to crash when the remote directory contains a certain number of entries.


  - Completely rewrites pysmb. API is not compatible with previous pysmb-0.x.x
  - Supports NTLMv1 and NTLMv2 authentication
  - Adds in NMB/SMB protocol implementation for use with Twisted framework
  - Tested with Windows XP SP3, Windows Vista, Windows 7 and Samba 3.x
  - Requires Python 2.4.4 or later, and pyasn1. Not tested with Python3


  - Prevents pysmb from failing when there are too many files/folders to
  be returned in a single SMB TRANS2 call. pysmb will "resume" requesting
  for more files/folders information in subsequent SMB TRANS2 requests.


  - Add in support for AMK's Python Cryptography Toolkit which will be used
  for DES password hashing. If AMK's pycrypto is found, it will be used
  instead of mxCrypto.


  - Fix a bug which fails to close the socket in on socket exception
  - Fix a bug which fails to close the NetBIOSSession in if the session
  has not been properly established yet.


  - Add new methods to SharedFile instances, get_mtime_epoch, get_atime_epoch
  and get_ctime_epoch. These methods will return the mtime, atime and ctime in
  epoch time rather than SMB time.
  - Remove debugging printout in which has been released accidentally
  with the last release.
  - Fix a bug in smbcp which causes to local to remote copy to fail


  - Fix a bug in which does not return the correct file size for files
  with their archive bits turned off. This results in these files not being
  retrieved or sent properly.
  - Fix some typo error in the documentations


  - Use NT LM0.12 dialect.
  - New smb.SMBMachine class
  - Add SMB.get_server_domain(), smb.get_server_os(), SMB.get_server_lanman()


  - Fix a problem with some Windows server where an UID is required when server is in share mode.
  Now, pysmb calls login() with empty authentication information when server is in share mode.
  - Add TYPE_DOMAIN_MASTER constant and description to


  - Add support for services in share mode. Minor changes to smb.SMB class API.
  - Fix a bug in's __raw_retr_file which has failed to initialize the max_buf_size prior to usage.
  - Fix a bug in smblistshare which fails to print the correct NMB error message
  - Modify not throw AttributeError in the destructor when there is an error while creating a session
  in the constructor


  - Add support for encrypted authentication using DES
  - Fix a bug(?) which treats all services and filenames as case-sensitive


  - Fix a bug in smblistshare and smbdu which fails to catch the nmb.NetBIOSError raised when session
  setup fails.
  - Fix a bug in smb.SMB that arises from the change in nmb.NetBIOSSession which sends
  the session port number as the remote host type.


  - Fix a bug in nmb.NetBIOSSession which specifies a TYPE_WORKSTATION for remote host instead of TYPE_SERVER.
  - Minor change to nmb.NetBIOSSession constructor API.
  - Fix a bug in smbdu which raises OverflowError when printing long file size values.
  - Fix a bug in smbcp which does not handle the destination path correctly when
  the source file is copied to a different filename.


  - Change nmb's NetBIOS and NetBIOSSession class such that they raise a NetBIOSError
  with a tuple of ( err_msg, err_class, err_code )
  - Add a function strerror() in both smb and nmb to return human readable messages
  for error codes.
  - Fix a bug in smbcp which fails to print an error message and terminate when the
  remote source path is not found.
  - Add in another utility, smblistshare.


  - First public release