IT13701: CLIENT CRASHES DURING BACKUP WHEN PROCESSING AN INVALID DIRECTORY STRUCTURE

IBM Spectrum Protectâ„¢ Client 8.1.0 Downloads and READMEs

APAR status

• Closed as fixed if next.

Error description

• 02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5152):
  fioScanDirEntry(): Directory
  '\\testsystem\c$\TopLevel\2ndLevel\3rdLevel' opened
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5236):
  fioScanDirEntry():  Object: 'com'
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(9612):
  GetFileSecurityInfo(): Get security descriptors in new format
  for 'C:\TopLevel\2ndLevel\3rdLevel\com'
  for 'C:\TopLevel\2ndLevel\3rdLevel\com\com'
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(9777):
  GetFileSecurityInfo(): size of the SDs is 144.
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5578):
  fioScanDirEntry(): Obtained NTFS File Security Info.
  02/01/2016 09:24:02.326 : ..\..\common\winnt\ntbackup.cpp( 271):
  GetBackupStreamInfo(C:\TopLevel\2ndLevel\3rdLevel\com\com):
  CreateFile with FILE_FLAGS 35651584.
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5750):
  fioGetAttrib(): Named Streams = 0, Aggregate named stream data =
  0.0
  02/01/2016 09:24:02.326 : ..\..\common\fio\fileio.cpp( 779):
  fioGetFirstDirEntry(): fioScanDirEntry returns rc(0) for
  fullpath(C:\TopLevel\2ndLevel\3rdLevel\com\com)
  02/01/2016 09:24:02.326 : ..\..\common\ba\incrdrv.cpp(9560):
  FillDirTree: Building list with known files...
  02/01/2016 09:24:02.326 : ..\..\common\ba\incrdrv.cpp(10266):
  PrivIncrFileSpace(): Local subdirectories at level
  \\testsystem\c$\TopLevel\2ndLevel\3rdLevel\com
  02/01/2016 09:24:02.326 : ..\..\common\ba\incrdrv.cpp(10269):
  \com
  ...
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5152):
  fioScanDirEntry(): Directory
  '\\testsystem\c$\TopLevel\2ndLevel\3rdLevel\com\com' opened
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(5236):
  fioScanDirEntry():  Object: 'com'
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(9612):
  GetFileSecurityInfo(): Get security descriptors in new format
  for 'C:\TopLevel\2ndLevel\3rdLevel\com\com\com'
  02/01/2016 09:24:02.326 : ..\..\common\fio\ntfileio.cpp(9777):
  GetFileSecurityInfo(): size of the SDs is 144.
  The client continues to traverse the directory path and crashes
  at some point after the path is hundreds of levels deep and
  thousands of characters long.  This is an invalid directory
  structure as the Microsoft Windows operating system limits
  path\filenames to 255 characters.
  Customer/L2 Diagnostics:
  A SERVICE trace will show the client evaluating an invalid
  directory structure.
  Load the dump in the Windows Debugger, determine if the crash
  was a stack overflow, do !analyze -v, and see the recursive
  nature of the call stack
  
  Initial Impact: High
  Tivoli Storage Manager Versions Affected:
  7.1.4
  
  Additional Keywords: TSM Tivoli Storage Manager
  

Local fix

• Resolve the invalid directory structure or exclude the directory
  using the exclude.dir option.
  

Problem summary

• ****************************************************************
  * USERS AFFECTED:                                              *
  * Backup-archive Java GUI and command line clients of version  *
  * 7.1 running on all Windows platforms                         *
  ****************************************************************
  * PROBLEM DESCRIPTION:                                         *
  * See ERROR DESCRIPTION                                        *
  ****************************************************************
  * RECOMMENDATION:                                              *
  * *                                                            *
  ****************************************************************
  *
  

Problem conclusion

• The client has been changed to allow a depth of 1400 directories
  (dir1\dir2\...\dir1400). When a directory structure exceeds this
  depth, the operation stops and ANS6718E error message is
  displayed. In addition to that, the following error message is
  logged to dsmerror.log file and to a trace file if traces are
  enabled (at least with the GENERAL traceflag set):
  
       ANS0361I DIAG: ERROR: PrivIncrFileSpace(): path
  '\\PC_Name\Volume_Name\dir1\dir2\...\dir1400' contains more
  directory levels than it can be processed...
  
  
  The fix for this APAR adds new message ANS6718E:
  
       Message text
       --------------------------------
       ANS6718E The path contains too many nested subdirectories.
  The maximum number of nested  directories is 1400.
  
  
       Explanation
       --------------------------------
       To avoid exhausting system resources, the client stops
  processing directory
       structures that exceed the maximum nesting depth.
  Directories that exceed
       the maximum nesting depth are not typical.
  
  
       System Action
       --------------------------------
       Processing of the current operation is stopped.
  
  
       User Response
       --------------------------------
       Determine whether the directory is valid. Directory
  structures of this depth are
       not typical, and could indicate a problem with the file
  system structure. An
       example of such a directory is if the directory is
  cyclical.
  
       If the directory is not valid, remove or repair the
  directory, then try the
       operation again.
  
       If the directory is valid, reduce the depth of the
  directory structure. Then try
       the operation again.
  
       Alternatively you can use an EXCLUDE.DIR statement to
  exclude the directory from
       backup or archive processing. Then try the operation again.
  

Temporary fix

Comments

• If there is a next release of Tivoli Storage Manager after 7.1,
  this APAR will be fixed in that next release.
  

APAR Information

• APAR is sysrouted FROM one or more of the following:

• APAR is sysrouted TO one or more of the following:

Modules/Macros

• dsm
  

Fix information

Applicable component levels

• R71W PSY

     UP