[svn-r18943] Purpose:

    Support follow symbolic links.

Description:
    Add '--follow-symlinks' option to follow symbolic links (soft and external).
    Update help page according to RM.
    Remove some warning messages from compiler.

Tested:
    jam, amani and linew

20 files changed, 271 insertions, 97 deletions

diff --git a/tools/testfiles/help-1.ls b/tools/testfiles/help-1.ls
index 4c45570..1b5de0c 100644
--- a/tools/testfiles/help-1.ls
+++ b/tools/testfiles/help-1.ls
@@ -2,27 +2,43 @@
  output for 'h5ls -w80 -h'
 #############################
 usage: h5ls [OPTIONS] [OBJECTS...]
-   OPTIONS
-      -h, -?, --help   Print a usage message and exit
-      -a, --address    Print addresses for raw data
-      -d, --data       Print the values of datasets
-      -e, --errors     Show all HDF5 error reporting
-      -E, --external   Allow traversal into external files
-      -f, --full       Print full path names instead of base names
-      -g, --group      Show information about a group, not its contents
-      -l, --label      Label members of compound datasets
-      -r, --recursive  List all groups recursively, avoiding cycles
-      -s, --string     Print 1-byte integer datasets as ASCII
-      -S, --simple     Use a machine-readable output format
-      -wN, --width=N   Set the number of columns of output
-      -v, --verbose    Generate more verbose output
-      -V, --version    Print version number and exit
-      --vfd=DRIVER     Use the specified virtual file driver
-      -x, --hexdump    Show raw data in hexadecimal format
+  OPTIONS
+   -h, -?, --help     Print a usage message and exit
+   -a, --address      Print addresses for raw data
+   -d, --data         Print the values of datasets
+   -e, --errors       Show all HDF5 error reporting
+   --follow-symlinks  Follow symbolic links (soft links and external links)
+                      to display target object information.
+                      Without this option, h5ls identifies a symbolic link
+                      as a soft link or external link and prints the value
+                      assigned to the symbolic link; it does not provide any
+                      information regarding the target object or determine
+                      whether the link is a dangling link.
+   -f, --full         Print full path names instead of base names
+   -g, --group        Show information about a group, not its contents
+   -l, --label        Label members of compound datasets
+   -r, --recursive    List all groups recursively, avoiding cycles
+   -s, --string       Print 1-byte integer datasets as ASCII
+   -S, --simple       Use a machine-readable output format
+   -wN, --width=N     Set the number of columns of output
+   -v, --verbose      Generate more verbose output
+   -V, --version      Print version number and exit
+   --vfd=DRIVER       Use the specified virtual file driver
+   -x, --hexdump      Show raw data in hexadecimal format
 
-   OBJECTS
-      Each object consists of an HDF5 file name optionally followed by a
-      slash and an object name within the file (if no object is specified
-      within the file then the contents of the root group are displayed).
-      The file name may include a printf(3C) integer format such as
-      "%05d" to open a file family.
+  OBJECTS
+    Each object consists of an HDF5 file name optionally followed by a
+    slash and an object name within the file (if no object is specified
+    within the file then the contents of the root group are displayed).
+    The file name may include a printf(3C) integer format such as
+    "%05d" to open a file family.
+
+  Deprecated Options
+    The following options have been deprecated in HDF5. While they remain
+    available, they have been superseded as indicated and may be removed
+    from HDF5 in the future. Use the indicated replacement option in all
+    new work; where possible, existing scripts, et cetera, should also be
+    updated to use the replacement option.
+
+   -E or --external   Follow external links.
+                      Replaced by --follow-symlinks.
diff --git a/tools/testfiles/help-2.ls b/tools/testfiles/help-2.ls
index 522cb5a..6f7e75d 100644
--- a/tools/testfiles/help-2.ls
+++ b/tools/testfiles/help-2.ls
@@ -2,27 +2,43 @@
  output for 'h5ls -w80 -help'
 #############################
 usage: h5ls [OPTIONS] [OBJECTS...]
-   OPTIONS
-      -h, -?, --help   Print a usage message and exit
-      -a, --address    Print addresses for raw data
-      -d, --data       Print the values of datasets
-      -e, --errors     Show all HDF5 error reporting
-      -E, --external   Allow traversal into external files
-      -f, --full       Print full path names instead of base names
-      -g, --group      Show information about a group, not its contents
-      -l, --label      Label members of compound datasets
-      -r, --recursive  List all groups recursively, avoiding cycles
-      -s, --string     Print 1-byte integer datasets as ASCII
-      -S, --simple     Use a machine-readable output format
-      -wN, --width=N   Set the number of columns of output
-      -v, --verbose    Generate more verbose output
-      -V, --version    Print version number and exit
-      --vfd=DRIVER     Use the specified virtual file driver
-      -x, --hexdump    Show raw data in hexadecimal format
+  OPTIONS
+   -h, -?, --help     Print a usage message and exit
+   -a, --address      Print addresses for raw data
+   -d, --data         Print the values of datasets
+   -e, --errors       Show all HDF5 error reporting
+   --follow-symlinks  Follow symbolic links (soft links and external links)
+                      to display target object information.
+                      Without this option, h5ls identifies a symbolic link
+                      as a soft link or external link and prints the value
+                      assigned to the symbolic link; it does not provide any
+                      information regarding the target object or determine
+                      whether the link is a dangling link.
+   -f, --full         Print full path names instead of base names
+   -g, --group        Show information about a group, not its contents
+   -l, --label        Label members of compound datasets
+   -r, --recursive    List all groups recursively, avoiding cycles
+   -s, --string       Print 1-byte integer datasets as ASCII
+   -S, --simple       Use a machine-readable output format
+   -wN, --width=N     Set the number of columns of output
+   -v, --verbose      Generate more verbose output
+   -V, --version      Print version number and exit
+   --vfd=DRIVER       Use the specified virtual file driver
+   -x, --hexdump      Show raw data in hexadecimal format
 
-   OBJECTS
-      Each object consists of an HDF5 file name optionally followed by a
-      slash and an object name within the file (if no object is specified
-      within the file then the contents of the root group are displayed).
-      The file name may include a printf(3C) integer format such as
-      "%05d" to open a file family.
+  OBJECTS
+    Each object consists of an HDF5 file name optionally followed by a
+    slash and an object name within the file (if no object is specified
+    within the file then the contents of the root group are displayed).
+    The file name may include a printf(3C) integer format such as
+    "%05d" to open a file family.
+
+  Deprecated Options
+    The following options have been deprecated in HDF5. While they remain
+    available, they have been superseded as indicated and may be removed
+    from HDF5 in the future. Use the indicated replacement option in all
+    new work; where possible, existing scripts, et cetera, should also be
+    updated to use the replacement option.
+
+   -E or --external   Follow external links.
+                      Replaced by --follow-symlinks.
diff --git a/tools/testfiles/help-3.ls b/tools/testfiles/help-3.ls
index 22ad865..939c8eb 100644
--- a/tools/testfiles/help-3.ls
+++ b/tools/testfiles/help-3.ls
@@ -2,27 +2,43 @@
  output for 'h5ls -w80 -?'
 #############################
 usage: h5ls [OPTIONS] [OBJECTS...]
-   OPTIONS
-      -h, -?, --help   Print a usage message and exit
-      -a, --address    Print addresses for raw data
-      -d, --data       Print the values of datasets
-      -e, --errors     Show all HDF5 error reporting
-      -E, --external   Allow traversal into external files
-      -f, --full       Print full path names instead of base names
-      -g, --group      Show information about a group, not its contents
-      -l, --label      Label members of compound datasets
-      -r, --recursive  List all groups recursively, avoiding cycles
-      -s, --string     Print 1-byte integer datasets as ASCII
-      -S, --simple     Use a machine-readable output format
-      -wN, --width=N   Set the number of columns of output
-      -v, --verbose    Generate more verbose output
-      -V, --version    Print version number and exit
-      --vfd=DRIVER     Use the specified virtual file driver
-      -x, --hexdump    Show raw data in hexadecimal format
+  OPTIONS
+   -h, -?, --help     Print a usage message and exit
+   -a, --address      Print addresses for raw data
+   -d, --data         Print the values of datasets
+   -e, --errors       Show all HDF5 error reporting
+   --follow-symlinks  Follow symbolic links (soft links and external links)
+                      to display target object information.
+                      Without this option, h5ls identifies a symbolic link
+                      as a soft link or external link and prints the value
+                      assigned to the symbolic link; it does not provide any
+                      information regarding the target object or determine
+                      whether the link is a dangling link.
+   -f, --full         Print full path names instead of base names
+   -g, --group        Show information about a group, not its contents
+   -l, --label        Label members of compound datasets
+   -r, --recursive    List all groups recursively, avoiding cycles
+   -s, --string       Print 1-byte integer datasets as ASCII
+   -S, --simple       Use a machine-readable output format
+   -wN, --width=N     Set the number of columns of output
+   -v, --verbose      Generate more verbose output
+   -V, --version      Print version number and exit
+   --vfd=DRIVER       Use the specified virtual file driver
+   -x, --hexdump      Show raw data in hexadecimal format
 
-   OBJECTS
-      Each object consists of an HDF5 file name optionally followed by a
-      slash and an object name within the file (if no object is specified
-      within the file then the contents of the root group are displayed).
-      The file name may include a printf(3C) integer format such as
-      "%05d" to open a file family.
+  OBJECTS
+    Each object consists of an HDF5 file name optionally followed by a
+    slash and an object name within the file (if no object is specified
+    within the file then the contents of the root group are displayed).
+    The file name may include a printf(3C) integer format such as
+    "%05d" to open a file family.
+
+  Deprecated Options
+    The following options have been deprecated in HDF5. While they remain
+    available, they have been superseded as indicated and may be removed
+    from HDF5 in the future. Use the indicated replacement option in all
+    new work; where possible, existing scripts, et cetera, should also be
+    updated to use the replacement option.
+
+   -E or --external   Follow external links.
+                      Replaced by --follow-symlinks.
diff --git a/tools/testfiles/textlinksrc-1-old.ls b/tools/testfiles/textlinksrc-1-old.ls
new file mode 100644
index 0000000..5e81dec
--- /dev/null
+++ b/tools/testfiles/textlinksrc-1-old.ls
@@ -0,0 +1,19 @@
+#############################
+ output for 'h5ls -w80 -Er textlinksrc.h5'
+#############################
+/                        Group
+/ext_link1               External Link {textlinktar.h5//group} {Group}
+/ext_link1/dset          Dataset {6}
+/ext_link1/elink_t1      External Link {textlinksrc.h5//} {Group}
+/ext_link1/elink_t1/ext_link1 External Link {textlinktar.h5//group} {Already Visited}
+/ext_link1/elink_t1/ext_link2 External Link {textlinktar.h5//dset} {Dataset {6}}
+/ext_link1/elink_t1/ext_link3 External Link {textlinktar.h5//type} {Type}
+/ext_link1/elink_t1/ext_link4 External Link {textlinktar.h5//group/elink_t2} {**NOT FOUND**}
+/ext_link1/elink_t1/ext_link5 External Link {textlinktar.h5//empty_group} {Group}
+/ext_link1/elink_t2      External Link {textlinksrc.h5//ext_link4} {**NOT FOUND**}
+/ext_link1/subgroup      Group
+/ext_link1/subgroup/link_to_group Group, same as /ext_link1
+/ext_link2               External Link {textlinktar.h5//dset} {Already Visited}
+/ext_link3               External Link {textlinktar.h5//type} {Already Visited}
+/ext_link4               External Link {textlinktar.h5//group/elink_t2} {Already Visited}
+/ext_link5               External Link {textlinktar.h5//empty_group} {Already Visited}
diff --git a/tools/testfiles/textlinksrc-1.ls b/tools/testfiles/textlinksrc-1.ls
index 5e81dec..f39eec9 100644
--- a/tools/testfiles/textlinksrc-1.ls
+++ b/tools/testfiles/textlinksrc-1.ls
@@ -1,5 +1,5 @@
 #############################
- output for 'h5ls -w80 -Er textlinksrc.h5'
+ output for 'h5ls -w80 --follow-symlinks -r textlinksrc.h5'
 #############################
 /                        Group
 /ext_link1               External Link {textlinktar.h5//group} {Group}
diff --git a/tools/testfiles/textlinksrc-2-old.ls b/tools/testfiles/textlinksrc-2-old.ls
new file mode 100644
index 0000000..acdc3d2
--- /dev/null
+++ b/tools/testfiles/textlinksrc-2-old.ls
@@ -0,0 +1,8 @@
+#############################
+ output for 'h5ls -w80 -Erv textlinksrc.h5/ext_link5'
+#############################
+Opened "textlinksrc.h5" with sec2 driver.
+ext_link5                External Link {textlinktar.h5//empty_group} {Group
+    Location:  3:1832
+    Links:     1
+}
diff --git a/tools/testfiles/textlinksrc-2.ls b/tools/testfiles/textlinksrc-2.ls
index acdc3d2..ea99be8 100644
--- a/tools/testfiles/textlinksrc-2.ls
+++ b/tools/testfiles/textlinksrc-2.ls
@@ -1,5 +1,5 @@
 #############################
- output for 'h5ls -w80 -Erv textlinksrc.h5/ext_link5'
+ output for 'h5ls -w80 --follow-symlinks -rv textlinksrc.h5/ext_link5'
 #############################
 Opened "textlinksrc.h5" with sec2 driver.
 ext_link5                External Link {textlinktar.h5//empty_group} {Group
diff --git a/tools/testfiles/textlinksrc-3-old.ls b/tools/testfiles/textlinksrc-3-old.ls
new file mode 100644
index 0000000..a86ca32
--- /dev/null
+++ b/tools/testfiles/textlinksrc-3-old.ls
@@ -0,0 +1,14 @@
+#############################
+ output for 'h5ls -w80 -Er textlinksrc.h5/ext_link1'
+#############################
+ext_link1                External Link {textlinktar.h5//group} {Group}
+/dset                    Dataset {6}
+/elink_t1                External Link {textlinksrc.h5//} {Group}
+/elink_t1/ext_link1      External Link {textlinktar.h5//group} {Already Visited}
+/elink_t1/ext_link2      External Link {textlinktar.h5//dset} {Dataset {6}}
+/elink_t1/ext_link3      External Link {textlinktar.h5//type} {Type}
+/elink_t1/ext_link4      External Link {textlinktar.h5//group/elink_t2} {**NOT FOUND**}
+/elink_t1/ext_link5      External Link {textlinktar.h5//empty_group} {Group}
+/elink_t2                External Link {textlinksrc.h5//ext_link4} {**NOT FOUND**}
+/subgroup                Group
+/subgroup/link_to_group  Group, same as /ext_link1
diff --git a/tools/testfiles/textlinksrc-3.ls b/tools/testfiles/textlinksrc-3.ls
index a86ca32..bd173f3 100644
--- a/tools/testfiles/textlinksrc-3.ls
+++ b/tools/testfiles/textlinksrc-3.ls
@@ -1,5 +1,5 @@
 #############################
- output for 'h5ls -w80 -Er textlinksrc.h5/ext_link1'
+ output for 'h5ls -w80 --follow-symlinks -r textlinksrc.h5/ext_link1'
 #############################
 ext_link1                External Link {textlinktar.h5//group} {Group}
 /dset                    Dataset {6}
diff --git a/tools/testfiles/textlinksrc-6-old.ls b/tools/testfiles/textlinksrc-6-old.ls
new file mode 100644
index 0000000..e1b8b74
--- /dev/null
+++ b/tools/testfiles/textlinksrc-6-old.ls
@@ -0,0 +1,8 @@
+#############################
+ output for 'h5ls -w80 -E textlinksrc.h5'
+#############################
+ext_link1                External Link {textlinktar.h5//group} {Group}
+ext_link2                External Link {textlinktar.h5//dset} {Dataset {6}}
+ext_link3                External Link {textlinktar.h5//type} {Type}
+ext_link4                External Link {textlinktar.h5//group/elink_t2} {**NOT FOUND**}
+ext_link5                External Link {textlinktar.h5//empty_group} {Group}
diff --git a/tools/testfiles/textlinksrc-6.ls b/tools/testfiles/textlinksrc-6.ls
index e1b8b74..6cda888 100644
--- a/tools/testfiles/textlinksrc-6.ls
+++ b/tools/testfiles/textlinksrc-6.ls
@@ -1,5 +1,5 @@
 #############################
- output for 'h5ls -w80 -E textlinksrc.h5'
+ output for 'h5ls -w80 --follow-symlinks textlinksrc.h5'
 #############################
 ext_link1                External Link {textlinktar.h5//group} {Group}
 ext_link2                External Link {textlinktar.h5//dset} {Dataset {6}}
diff --git a/tools/testfiles/textlinksrc-7-old.ls b/tools/testfiles/textlinksrc-7-old.ls
new file mode 100644
index 0000000..9249d0c
--- /dev/null
+++ b/tools/testfiles/textlinksrc-7-old.ls
@@ -0,0 +1,4 @@
+#############################
+ output for 'h5ls -w80 -E textlinksrc.h5/ext_link1'
+#############################
+ext_link1                External Link {textlinktar.h5//group} {Group}
diff --git a/tools/testfiles/textlinksrc-7.ls b/tools/testfiles/textlinksrc-7.ls
index 9249d0c..528c4c5 100644
--- a/tools/testfiles/textlinksrc-7.ls
+++ b/tools/testfiles/textlinksrc-7.ls
@@ -1,4 +1,4 @@
 #############################
- output for 'h5ls -w80 -E textlinksrc.h5/ext_link1'
+ output for 'h5ls -w80 --follow-symlinks textlinksrc.h5/ext_link1'
 #############################
 ext_link1                External Link {textlinktar.h5//group} {Group}
diff --git a/tools/testfiles/tgroup-1.ls b/tools/testfiles/tgroup-1.ls
index 5401cd7..8d38e0f 100644
--- a/tools/testfiles/tgroup-1.ls
+++ b/tools/testfiles/tgroup-1.ls
@@ -4,27 +4,43 @@
 Error: 'recursive' option not compatible with 'group info' option!
 
 usage: h5ls [OPTIONS] [OBJECTS...]
-   OPTIONS
-      -h, -?, --help   Print a usage message and exit
-      -a, --address    Print addresses for raw data
-      -d, --data       Print the values of datasets
-      -e, --errors     Show all HDF5 error reporting
-      -E, --external   Allow traversal into external files
-      -f, --full       Print full path names instead of base names
-      -g, --group      Show information about a group, not its contents
-      -l, --label      Label members of compound datasets
-      -r, --recursive  List all groups recursively, avoiding cycles
-      -s, --string     Print 1-byte integer datasets as ASCII
-      -S, --simple     Use a machine-readable output format
-      -wN, --width=N   Set the number of columns of output
-      -v, --verbose    Generate more verbose output
-      -V, --version    Print version number and exit
-      --vfd=DRIVER     Use the specified virtual file driver
-      -x, --hexdump    Show raw data in hexadecimal format
+  OPTIONS
+   -h, -?, --help     Print a usage message and exit
+   -a, --address      Print addresses for raw data
+   -d, --data         Print the values of datasets
+   -e, --errors       Show all HDF5 error reporting
+   --follow-symlinks  Follow symbolic links (soft links and external links)
+                      to display target object information.
+                      Without this option, h5ls identifies a symbolic link
+                      as a soft link or external link and prints the value
+                      assigned to the symbolic link; it does not provide any
+                      information regarding the target object or determine
+                      whether the link is a dangling link.
+   -f, --full         Print full path names instead of base names
+   -g, --group        Show information about a group, not its contents
+   -l, --label        Label members of compound datasets
+   -r, --recursive    List all groups recursively, avoiding cycles
+   -s, --string       Print 1-byte integer datasets as ASCII
+   -S, --simple       Use a machine-readable output format
+   -wN, --width=N     Set the number of columns of output
+   -v, --verbose      Generate more verbose output
+   -V, --version      Print version number and exit
+   --vfd=DRIVER       Use the specified virtual file driver
+   -x, --hexdump      Show raw data in hexadecimal format
 
-   OBJECTS
-      Each object consists of an HDF5 file name optionally followed by a
-      slash and an object name within the file (if no object is specified
-      within the file then the contents of the root group are displayed).
-      The file name may include a printf(3C) integer format such as
-      "%05d" to open a file family.
+  OBJECTS
+    Each object consists of an HDF5 file name optionally followed by a
+    slash and an object name within the file (if no object is specified
+    within the file then the contents of the root group are displayed).
+    The file name may include a printf(3C) integer format such as
+    "%05d" to open a file family.
+
+  Deprecated Options
+    The following options have been deprecated in HDF5. While they remain
+    available, they have been superseded as indicated and may be removed
+    from HDF5 in the future. Use the indicated replacement option in all
+    new work; where possible, existing scripts, et cetera, should also be
+    updated to use the replacement option.
+
+   -E or --external   Follow external links.
+                      Replaced by --follow-symlinks.
diff --git a/tools/testfiles/tsoftlinks-1.ls b/tools/testfiles/tsoftlinks-1.ls
new file mode 100644
index 0000000..fc57da9
--- /dev/null
+++ b/tools/testfiles/tsoftlinks-1.ls
@@ -0,0 +1,13 @@
+#############################
+ output for 'h5ls --follow-symlinks tsoftlinks.h5'
+#############################
+dset1                    Dataset {4, 2}
+dset2                    Dataset {4, 2}
+dtype                    Type
+group1                   Group
+group_empty              Group
+soft_dangle              Soft Link {not_yet} {**NOT FOUND**}
+soft_dset1               Soft Link {/dset1} {Dataset {4, 2}}
+soft_dtype               Soft Link {/dtype} {Type}
+soft_empty_grp           Soft Link {/group_empty} {Group}
+soft_group1              Soft Link {/group1} {Group}
diff --git a/tools/testfiles/tsoftlinks-2.ls b/tools/testfiles/tsoftlinks-2.ls
new file mode 100644
index 0000000..3566f70
--- /dev/null
+++ b/tools/testfiles/tsoftlinks-2.ls
@@ -0,0 +1,24 @@
+#############################
+ output for 'h5ls --follow-symlinks -r tsoftlinks.h5'
+#############################
+/                        Group
+/dset1                   Dataset {4, 2}
+/dset2                   Dataset {4, 2}
+/dtype                   Type
+/group1                  Group
+/group1/soft_dangle      Soft Link {not_yet} {**NOT FOUND**}
+/group1/soft_dset1       Soft Link {/dset1} {Dataset {4, 2}}
+/group1/soft_dset2       Soft Link {/dset2} {Dataset {4, 2}}
+/group1/soft_dtype       Soft Link {/dtype} {Type}
+/group1/soft_empty_grp   Soft Link {/group_empty} {Group}
+/group_empty             Group
+/soft_dangle             Soft Link {not_yet} {Already Visited}
+/soft_dset1              Soft Link {/dset1} {Already Visited}
+/soft_dtype              Soft Link {/dtype} {Already Visited}
+/soft_empty_grp          Soft Link {/group_empty} {Already Visited}
+/soft_group1             Soft Link {/group1} {Group}
+/soft_group1/soft_dangle Soft Link {not_yet} {Already Visited}
+/soft_group1/soft_dset1  Soft Link {/dset1} {Already Visited}
+/soft_group1/soft_dset2  Soft Link {/dset2} {Already Visited}
+/soft_group1/soft_dtype  Soft Link {/dtype} {Already Visited}
+/soft_group1/soft_empty_grp Soft Link {/group_empty} {Already Visited}
diff --git a/tools/testfiles/tsoftlinks-3.ls b/tools/testfiles/tsoftlinks-3.ls
new file mode 100644
index 0000000..2face70
--- /dev/null
+++ b/tools/testfiles/tsoftlinks-3.ls
@@ -0,0 +1,8 @@
+#############################
+ output for 'h5ls --follow-symlinks tsoftlinks.h5/group1'
+#############################
+soft_dangle              Soft Link {not_yet} {**NOT FOUND**}
+soft_dset1               Soft Link {/dset1} {Dataset {4, 2}}
+soft_dset2               Soft Link {/dset2} {Dataset {4, 2}}
+soft_dtype               Soft Link {/dtype} {Type}
+soft_empty_grp           Soft Link {/group_empty} {Group}
diff --git a/tools/testfiles/tsoftlinks-4.ls b/tools/testfiles/tsoftlinks-4.ls
new file mode 100644
index 0000000..c1f4568
--- /dev/null
+++ b/tools/testfiles/tsoftlinks-4.ls
@@ -0,0 +1,8 @@
+#############################
+ output for 'h5ls --follow-symlinks -r tsoftlinks.h5/group1'
+#############################
+/soft_dangle             Soft Link {not_yet} {**NOT FOUND**}
+/soft_dset1              Soft Link {/dset1} {Dataset {4, 2}}
+/soft_dset2              Soft Link {/dset2} {Dataset {4, 2}}
+/soft_dtype              Soft Link {/dtype} {Type}
+/soft_empty_grp          Soft Link {/group_empty} {Group}
diff --git a/tools/testfiles/tsoftlinks-5.ls b/tools/testfiles/tsoftlinks-5.ls
new file mode 100644
index 0000000..6e915e1
--- /dev/null
+++ b/tools/testfiles/tsoftlinks-5.ls
@@ -0,0 +1,4 @@
+#############################
+ output for 'h5ls --follow-symlinks tsoftlinks.h5/soft_dset1'
+#############################
+soft_dset1               Soft Link {/dset1} {Dataset {4, 2}}
diff --git a/tools/testfiles/tsoftlinks.h5 b/tools/testfiles/tsoftlinks.h5
new file mode 100644
index 0000000..01ea922
--- /dev/null
+++ b/tools/testfiles/tsoftlinks.h5