path: root/doc/developer-guide
diff options
authorJiffin Tony Thottan <>2015-08-11 16:00:47 +0530
committerKaleb KEITHLEY <>2015-08-24 09:21:51 -0700
commit1ead86a8bcbfe4045729466e4b98f765f3c13c8d (patch)
tree7eb50e8dfbf012678e53f757d619c5ef6c901a15 /doc/developer-guide
parent5044b20a9fbe0f49b7929d2282890a7351df344d (diff)
libgfapi: adding 'follow' flag to glfs_h_lookupat()
Previously glfs_h_lookupat won't follow the symlink, this patch introduces new flag `follow` which will resolve the same. Applications linking against the new library will need to use the new glfs_h_lookupat API call. In order to stay compatible with existing binaries that use the previous glfs_h_lookupat() function, the old symbol needs to stay available. Verification that there are two versions of glfs_h_lookupat: $ objdump -T /usr/lib64/ | grep -w glfs_h_lookupat 0000000000015070 g DF .text 000000000000021e GFAPI_3.7.4 glfs_h_lookupat 0000000000015290 g DF .text 0000000000000008 (GFAPI_3.4.2) glfs_h_lookupat Testing with a binary (based on anonymous_fd_read_write.c from ./tests/) that was linked against the old library: $ objdump -T ./lookupat | grep -w glfs_h_lookupat 0000000000000000 DF *UND* 0000000000000000 GFAPI_3.4.2 glfs_h_lookupat Enable debugging for '' so that we can check that the GFAPI_3.4.2 version of the symbol gets loaded: $ export LD_DEBUG_OUTPUT=lookupat.ld.log LD_DEBUG=all $ ./lookupat $ grep -w glfs_h_lookupat lookupat.ld.log.2543 2543: symbol=glfs_h_lookupat; lookup in file=./lookupat [0] 2543: symbol=glfs_h_lookupat; lookup in file=/lib64/ [0] 2543: binding file ./lookupat [0] to /lib64/ [0]: normal symbol `glfs_h_lookupat' [GFAPI_3.4.2] Change-Id: I8bf9b1c19a0585f681bc1a7f84aad1ccd0f75f6a BUG: 1252410 Signed-off-by: Jiffin Tony Thottan <> Signed-off-by: Niels de Vos <> Reviewed-on: Reviewed-by: soumya k <> Reviewed-by: Kaleb KEITHLEY <> Tested-by: NetBSD Build System <>
Diffstat (limited to 'doc/developer-guide')
1 files changed, 1 insertions, 1 deletions
diff --git a/doc/developer-guide/gfapi-symbol-versions/ b/doc/developer-guide/gfapi-symbol-versions/
index e4f4fe9..c7a3ac9 100644
--- a/doc/developer-guide/gfapi-symbol-versions/
+++ b/doc/developer-guide/gfapi-symbol-versions/
@@ -29,7 +29,7 @@ file remains forever. Legacy APIs may or may not have an
associated symbol version. New APIs may or may not have an associated
symbol version either. In general symbol versions are reserved for APIs
that have changed. Either the function's signature has changed, i.e. the
-return time or the number of paramaters, and/or the parameter types have
+return type or the number of paramaters, and/or the parameter types have
changed. Another reason for using symbol versions on an API is when the
behaviour or functionality of the API changes dramatically. As with a
library that doesn't use versioned symbols, old and new applications