{"schema":"libjg2-1", "vpath":"/git/", "avatar":"/git/avatar/", "alang":"", "gen_ut":1754121997, "reponame":"openssl", "desc":"OpenSSL", "owner": { "name": "Andy Green", "email": "andy@warmcat.com", "md5": "c50933ca2aa61e0fe2c43d46bb6b59cb" },"url":"https://warmcat.com/repo/openssl", "f":3, "items": [ {"schema":"libjg2-1", "cid":"dc20b735d1f4af4931194928b077fc3f", "commit": {"type":"commit", "time": 1501183933, "time_ofs": 18446744073709551316, "oid_tree": { "oid": "8e17532a526f8699b4c63ad37243686a8e3a630a", "alias": []}, "oid":{ "oid": "1fb2993d9e3db38c7c681ea3eecaad458e956f80", "alias": []}, "msg": "Catch up to the removal of OSSL_STORE_open_file()", "sig_commit": { "git_time": { "time": 1501183933, "offset": -300 }, "name": "Benjamin Kaduk", "email": "kaduk@mit.edu", "md5": "4658a77df5a10149cf73d60e70f70b2d" }, "sig_author": { "git_time": { "time": 1498767138, "offset": -300 }, "name": "Benjamin Kaduk", "email": "bkaduk@akamai.com", "md5": "a05981ba89c2b7753f6e41ad2046bdd8" }}, "body": "Catch up to the removal of OSSL_STORE_open_file()\n\nRemove references to it in documentation.\n\nUnfortunately, it is too late to renumber symbols in libcrypto.num\nand avoid the NOEXIST entry there.\n\nReviewed-by: Richard Levitte \u003clevitte@openssl.org\u003e\n(Merged from https://github.com/openssl/openssl/pull/3860)\n" , "diff": "diff --git a/doc/man3/OSSL_STORE_INFO.pod b/doc/man3/OSSL_STORE_INFO.pod\nindex 1b0f233..9b9e93b 100644\n--- a/doc/man3/OSSL_STORE_INFO.pod\n+++ b/doc/man3/OSSL_STORE_INFO.pod\n@@ -117,10 +117,10 @@ used by the application to get the objects in that file.\n This can be applied to all schemes that can somehow support a listing\n of object URIs.\n \n-For C\u003cfile:\u003e URIs that are used without the explicit scheme, or paths\n-given to L\u003cOSSL_STORE_open_file(3)\u003e, the returned name will be the path of\n-each object, so if C\u003c/foo/bar\u003e was given and that path has the file\n-C\u003ccookie.pem\u003e, the name C\u003c/foo/bar/cookie.pem\u003e will be returned.\n+For C\u003cfile:\u003e URIs that are used without the explicit scheme, the\n+returned name will be the path of each object, so if C\u003c/foo/bar\u003e was\n+given and that path has the file C\u003ccookie.pem\u003e, the name\n+C\u003c/foo/bar/cookie.pem\u003e will be returned.\n \n At the discretion of the loader that was used to get these names, an\n extra description may be attached as well.\ndiff --git a/doc/man3/OSSL_STORE_open.pod b/doc/man3/OSSL_STORE_open.pod\nindex 1a2626c..0bc6d5c 100644\n--- a/doc/man3/OSSL_STORE_open.pod\n+++ b/doc/man3/OSSL_STORE_open.pod\n@@ -99,26 +99,14 @@ OSSL_STORE_register_loader().\n \n \u003dhead1 NOTES\n \n-When unsure whether a given string contains a simple file or directory\n-reference, or if it's a full blown URI, the question is how to figure\n-that out.\n-One way is to try OSSL_STORE_open_file() and if that fails, try\n-OSSL_STORE_open().\n-The other way is the other way around.\n-Either way you choose, there are corner cases,\n-F\u003cfile:/foo/bar/cookie.txt\u003e might very will be a simple file reference\n-on a system that supports the notion of volumes.\n-\n-This manual won't tell you which way is better, that's up to each\n-application developer to decide on their own.\n-However, there are some tools that can be used together with\n+A string without a scheme prefix (that is, a non-URI string) is\n+implicitly interpreted as using the F\u003cfile:\u003e scheme.\n+\n+There are some tools that can be used together with\n OSSL_STORE_open() to determine if any failure is caused by an unparsable\n URI, or if it's a different error (such as memory allocation\n failures); if the URI was parsable but the scheme unregistered, the\n top error will have the reason C\u003cOSSL_STORE_R_UNREGISTERED_SCHEME\u003e.\n-If you decide to use OSSL_STORE_open() with OSSL_STORE_open_file() as a\n-fallback, those reasons can be good tools to decide if the fallback\n-should be taken or not.\n \n \u003dhead1 RETURN VALUES\n \ndiff --git a/doc/man7/ossl_store.pod b/doc/man7/ossl_store.pod\nindex 59cfc7c..cda5ce4 100644\n--- a/doc/man7/ossl_store.pod\n+++ b/doc/man7/ossl_store.pod\n@@ -59,10 +59,6 @@ only).\n \n \u003dhead2 A generic call\n \n- /*\n- * There is also a OSSL_STORE_open_file() that can be used for file paths\n- * that can't be represented as URIs, such as Windows backslashes\n- */\n OSSL_STORE_CTX *ctx \u003d OSSL_STORE_open(\u0022file:/foo/bar/data.pem\u0022);\n \n /*\ndiff --git a/include/openssl/store.h b/include/openssl/store.h\nindex c6948f2..43cf203 100644\n--- a/include/openssl/store.h\n+++ b/include/openssl/store.h\n@@ -114,8 +114,7 @@ int OSSL_STORE_close(OSSL_STORE_CTX *ctx);\n \n /*\n * Functions to generate OSSL_STORE_INFOs, one function for each type we\n- * support having in them. Along with each of them, one macro that\n- * can be used to determine what types are supported.\n+ * support having in them, as well as a generic constructor.\n *\n * In all cases, ownership of the object is transfered to the OSSL_STORE_INFO\n * and will therefore be freed when the OSSL_STORE_INFO is freed.\n","s":{"c":1754121997,"u": 41004}} ],"g": 42118,"chitpc": 0,"ehitpc": 0,"indexed":0 , "ab": 0, "si": 0, "db":0, "di":0, "sat":0, "lfc": "0000"}