Function build_immutable_uri

src/store/store.c:681–731

Build a SQLite "file:" URI with immutable=1 from a filesystem path. * immutable=1 bypasses WAL and locking and reads the main DB file directly — * used only as a fallback for read-only filesystems where the wal-index * (-shm) cannot be created. URI-special characters are percent-encoded. * Windows backslashes are normalized to '/', and a leading '/' is inserted * for drive-letter paths so the

 * for drive-letter paths so the drive is not parsed as a URI authority.
 * Returns false if the output buffer is too small. */
static bool build_immutable_uri(const char *path, char *out, size_t out_sz) {
    static const char PREFIX[] = "file://";
    static const char SUFFIX[] = "?immutable=1";
    static const char HEX[] = "0123456789ABCDEF";
    size_t prefix_len = sizeof(PREFIX) - 1;
    size_t suffix_len = sizeof(SUFFIX) - 1;
    if (prefix_len + 1 > out_sz) {
        return false;
    }
    memcpy(out, PREFIX, prefix_len);
    size_t pos = prefix_len;

    /* Ensure the path component begins with '/' (POSIX absolute paths already
     * do; Windows "C:\..." gets a leading '/' -> "/C:/..."). */
    if (path[0] != '/') {
        if (pos + 1 >= out_sz) {
            return false;
        }
        out[pos++] = '/';
    }

    for (const unsigned char *p = (const unsigned char *)path; *p != '\0'; p++) {
        unsigned char c = *p;
        if (c == '\\') {
            c = '/'; /* normalize Windows separators */
        }
        bool safe = (c >= 'A' && c <= 'Z') || (c >= 'a' && c <= 'z') || (c >= '0' && c <= '9') ||
                    c == '/' || c == '.' || c == '-' || c == '_' || c == '~' || c == ':';
        if (safe) {
            if (pos + 1 >= out_sz) {
                return false;
            }
            out[pos++] = (char)c;
        } else {
            if (pos + 3 >= out_sz) {
                return false;
            }
            out[pos++] = '%';
            out[pos++] = HEX[(c >> 4) & 0xF];
            out[pos++] = HEX[c & 0xF];
        }
    }

    if (pos + suffix_len + 1 > out_sz) {
        return false;
    }
    memcpy(out + pos, SUFFIX, suffix_len);
    pos += suffix_len;
    out[pos] = '\0';
    return true;
}

cbm_store_t *cbm_store_open_path_query(const char *db_path) {
    if (!db_path) {