pg_tablespace.c

Go to the documentation of this file.

/*-------------------------------------------------------------------------
 *
 * pg_tablespace.c
 *    routines to support manipulation of the pg_tablespace relation
 *
 * Portions Copyright (c) 1996-2026, PostgreSQL Global Development Group
 * Portions Copyright (c) 1994, Regents of the University of California
 *
 *
 * IDENTIFICATION
 *    src/backend/catalog/pg_tablespace.c
 *
 *-------------------------------------------------------------------------
 */
#include "postgres.h"
 
#include <unistd.h>
#include <sys/stat.h>
 
#include "catalog/pg_tablespace.h"
#include "commands/tablespace.h"
#include "miscadmin.h"
 
 
/*
 * get_tablespace_location
 *      Get a tablespace's location as a C-string, by its OID
 */
char *
get_tablespace_location(Oid tablespaceOid)
{
    char        sourcepath[MAXPGPATH];
    char        targetpath[MAXPGPATH];
    int         rllen;
    struct stat st;
 
    /*
     * It's useful to apply this to pg_class.reltablespace, wherein zero means
     * "the database's default tablespace".  So, rather than throwing an error
     * for zero, we choose to assume that's what is meant.
     */
    if (tablespaceOid == InvalidOid)
        tablespaceOid = MyDatabaseTableSpace;
 
    /*
     * Return empty string for the cluster's default tablespaces
     */
    if (tablespaceOid == DEFAULTTABLESPACE_OID ||
        tablespaceOid == GLOBALTABLESPACE_OID)
        return pstrdup("");
 
    /*
     * Find the location of the tablespace by reading the symbolic link that
     * is in pg_tblspc/<oid>.
     */
    snprintf(sourcepath, sizeof(sourcepath), "%s/%u", PG_TBLSPC_DIR, tablespaceOid);
 
    /*
     * Before reading the link, check if the source path is a link or a
     * junction point.  Note that a directory is possible for a tablespace
     * created with allow_in_place_tablespaces enabled.  If a directory is
     * found, a relative path to the data directory is returned.
     */
    if (lstat(sourcepath, &st) < 0)
        ereport(ERROR,
                errcode_for_file_access(),
                errmsg("could not stat file \"%s\": %m",
                       sourcepath));
 
    if (!S_ISLNK(st.st_mode))
        return pstrdup(sourcepath);
 
    /*
     * In presence of a link or a junction point, return the path pointed to.
     */
    rllen = readlink(sourcepath, targetpath, sizeof(targetpath));
    if (rllen < 0)
        ereport(ERROR,
                errcode_for_file_access(),
                errmsg("could not read symbolic link \"%s\": %m",
                       sourcepath));
    if (rllen >= sizeof(targetpath))
        ereport(ERROR,
                errcode(ERRCODE_PROGRAM_LIMIT_EXCEEDED),
                errmsg("symbolic link \"%s\" target is too long",
                       sourcepath));
    targetpath[rllen] = '\0';
 
    return pstrdup(targetpath);
}