mirror of https://github.com/postgres/postgres
library. New configure option --with-ossp-uuid to activate.REL8_3_STABLE
Peter Eisentraut
18 years ago
parent
71495f296e
commit
74496bc298
@ -0,0 +1,19 @@ |
||||
# $PostgreSQL: pgsql/contrib/uuid-ossp/Makefile,v 1.1 2007/04/21 17:26:17 petere Exp $
|
||||
|
||||
MODULE_big = uuid-ossp
|
||||
OBJS = uuid-ossp.o
|
||||
DATA_built = uuid-ossp.sql
|
||||
DATA = uninstall_uuid-ossp.sql
|
||||
DOCS = README.uuid-ossp
|
||||
|
||||
SHLIB_LINK += -lossp-uuid
|
||||
|
||||
ifdef USE_PGXS |
||||
PGXS := $(shell pg_config --pgxs)
|
||||
include $(PGXS) |
||||
else |
||||
subdir = contrib/uuid-ossp
|
||||
top_builddir = ../..
|
||||
include $(top_builddir)/src/Makefile.global |
||||
include $(top_srcdir)/contrib/contrib-global.mk |
||||
endif |
||||
@ -0,0 +1,97 @@ |
||||
UUID Generation Functions |
||||
========================= |
||||
Peter Eisentraut <peter_e@gmx.net> |
||||
|
||||
This module provides functions to generate universally unique |
||||
identifiers (UUIDs) using one of the several standard algorithms, as |
||||
well as functions to produce certain special UUID constants. |
||||
|
||||
|
||||
Installation |
||||
------------ |
||||
|
||||
The extra library required can be found at |
||||
<http://www.ossp.org/pkg/lib/uuid/>. |
||||
|
||||
|
||||
UUID Generation |
||||
--------------- |
||||
|
||||
The relevant standards ITU-T Rec. X.667, ISO/IEC 9834-8:2005, and RFC |
||||
4122 specify four algorithms for generating UUIDs, identified by the |
||||
version numbers 1, 3, 4, and 5. (There is no version 2 algorithm.) |
||||
Each of these algorithms could be suitable for a different set of |
||||
applications. |
||||
|
||||
uuid_generate_v1() |
||||
~~~~~~~~~~~~~~~~~~ |
||||
|
||||
This function generates a version 1 UUID. This involves the MAC |
||||
address of the computer and a time stamp. Note that UUIDs of this |
||||
kind reveal the identity of the computer that created the identifier |
||||
and the time at which it did so, which might make it unsuitable for |
||||
certain security-sensitive applications. |
||||
|
||||
uuid_generate_v1mc() |
||||
~~~~~~~~~~~~~~~~~~~~ |
||||
|
||||
This function generates a version 1 UUID but uses a random multicast |
||||
MAC address instead of the real MAC address of the computer. |
||||
|
||||
uuid_generate_v3(namespace uuid, name text) |
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
||||
|
||||
This function generates a version 3 UUID in the given namespace using |
||||
the specified input name. The namespace should be one of the special |
||||
constants produced by the uuid_ns_*() functions shown below. (It |
||||
should be any UUID in theory.) The name is an identifier in the |
||||
selected namespace. For example: |
||||
|
||||
uuid_generate_v3(uuid_ns_url(), 'http://www.postgresql.org') |
||||
|
||||
The name parameter will be MD5-hashed, so the cleartext cannot be |
||||
derived from the generated UUID. |
||||
|
||||
The generation of UUIDs by this method has no random or |
||||
environment-dependent element and is therefore reproducible. |
||||
|
||||
uuid_generate_v4() |
||||
~~~~~~~~~~~~~~~~~~ |
||||
|
||||
This function generates a version 4 UUID, which is derived entirely |
||||
from random numbers. |
||||
|
||||
uuid_generate_v5(namespace uuid, name text) |
||||
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~ |
||||
|
||||
This function generates a version 5 UUID, which works like a version 3 |
||||
UUID except that SHA-1 is used as a hashing method. Version 5 should |
||||
be preferred over version 3 because SHA-1 is thought to be more secure |
||||
than MD5. |
||||
|
||||
|
||||
UUID Constants |
||||
-------------- |
||||
|
||||
uuid_nil() |
||||
|
||||
A "nil" UUID constant, which does not occur as a real UUID. |
||||
|
||||
uuid_ns_dns() |
||||
|
||||
Constant designating the DNS namespace for UUIDs. |
||||
|
||||
uuid_ns_url() |
||||
|
||||
Constant designating the URL namespace for UUIDs. |
||||
|
||||
uuid_ns_oid() |
||||
|
||||
Constant designating the ISO object identifier (OID) namespace for |
||||
UUIDs. (This pertains to ASN.1 OIDs, unrelated to the OIDs used in |
||||
PostgreSQL.) |
||||
|
||||
uuid_ns_x500() |
||||
|
||||
Constant designating the X.500 distinguished name (DN) namespace for |
||||
UUIDs. |
||||
@ -0,0 +1,15 @@ |
||||
/* $PostgreSQL: pgsql/contrib/uuid-ossp/uninstall_uuid-ossp.sql,v 1.1 2007/04/21 17:26:17 petere Exp $ */ |
||||
|
||||
SET search_path = public; |
||||
|
||||
DROP FUNCTION uuid_nil(); |
||||
DROP FUNCTION uuid_ns_dns(); |
||||
DROP FUNCTION uuid_ns_url(); |
||||
DROP FUNCTION uuid_ns_oid(); |
||||
DROP FUNCTION uuid_ns_x500(); |
||||
|
||||
DROP FUNCTION uuid_generate_v1(); |
||||
DROP FUNCTION uuid_generate_v1mc(); |
||||
DROP FUNCTION uuid_generate_v3(namespace uuid, name text); |
||||
DROP FUNCTION uuid_generate_v4(); |
||||
DROP FUNCTION uuid_generate_v5(namespace uuid, name text); |
||||
@ -0,0 +1,198 @@ |
||||
/*-------------------------------------------------------------------------
|
||||
* |
||||
* UUID generation functions using the OSSP UUID library |
||||
* |
||||
* Copyright (c) 2007 PostgreSQL Global Development Group |
||||
* |
||||
* $PostgreSQL: pgsql/contrib/uuid-ossp/uuid-ossp.c,v 1.1 2007/04/21 17:26:17 petere Exp $ |
||||
* |
||||
*------------------------------------------------------------------------- |
||||
*/ |
||||
|
||||
#include "postgres.h" |
||||
#include "fmgr.h" |
||||
#include "utils/builtins.h" |
||||
#include "utils/uuid.h" |
||||
|
||||
#include <ossp/uuid.h> |
||||
|
||||
|
||||
/* better both be 16 */ |
||||
#if (UUID_LEN != UUID_LEN_BIN) |
||||
#error UUID length mismatch |
||||
#endif |
||||
|
||||
|
||||
PG_MODULE_MAGIC; |
||||
|
||||
|
||||
Datum uuid_nil(PG_FUNCTION_ARGS); |
||||
Datum uuid_ns_dns(PG_FUNCTION_ARGS); |
||||
Datum uuid_ns_url(PG_FUNCTION_ARGS); |
||||
Datum uuid_ns_oid(PG_FUNCTION_ARGS); |
||||
Datum uuid_ns_x500(PG_FUNCTION_ARGS); |
||||
|
||||
Datum uuid_generate_v1(PG_FUNCTION_ARGS); |
||||
Datum uuid_generate_v1mc(PG_FUNCTION_ARGS); |
||||
Datum uuid_generate_v3(PG_FUNCTION_ARGS); |
||||
Datum uuid_generate_v4(PG_FUNCTION_ARGS); |
||||
Datum uuid_generate_v5(PG_FUNCTION_ARGS); |
||||
|
||||
|
||||
PG_FUNCTION_INFO_V1(uuid_nil); |
||||
PG_FUNCTION_INFO_V1(uuid_ns_dns); |
||||
PG_FUNCTION_INFO_V1(uuid_ns_url); |
||||
PG_FUNCTION_INFO_V1(uuid_ns_oid); |
||||
PG_FUNCTION_INFO_V1(uuid_ns_x500); |
||||
|
||||
PG_FUNCTION_INFO_V1(uuid_generate_v1); |
||||
PG_FUNCTION_INFO_V1(uuid_generate_v1mc); |
||||
PG_FUNCTION_INFO_V1(uuid_generate_v3); |
||||
PG_FUNCTION_INFO_V1(uuid_generate_v4); |
||||
PG_FUNCTION_INFO_V1(uuid_generate_v5); |
||||
|
||||
|
||||
static char * |
||||
uuid_to_string(const uuid_t *uuid) |
||||
{ |
||||
char *buf = palloc(UUID_LEN_STR + 1); |
||||
void *ptr = buf; |
||||
size_t len = UUID_LEN_STR + 1; |
||||
|
||||
uuid_export(uuid, UUID_FMT_STR, &ptr, &len); |
||||
|
||||
return buf; |
||||
} |
||||
|
||||
|
||||
static void |
||||
string_to_uuid(const char *str, uuid_t *uuid) |
||||
{ |
||||
uuid_import(uuid, UUID_FMT_STR, str, UUID_LEN_STR + 1); |
||||
} |
||||
|
||||
|
||||
static Datum |
||||
special_uuid_value(const char *name) |
||||
{ |
||||
uuid_t *uuid; |
||||
char *str; |
||||
|
||||
uuid_create(&uuid); |
||||
uuid_load(uuid, name); |
||||
str = uuid_to_string(uuid); |
||||
uuid_destroy(uuid); |
||||
|
||||
return DirectFunctionCall1(uuid_in, CStringGetDatum(str)); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_nil(PG_FUNCTION_ARGS) |
||||
{ |
||||
return special_uuid_value("nil"); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_ns_dns(PG_FUNCTION_ARGS) |
||||
{ |
||||
return special_uuid_value("ns:DNS"); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_ns_url(PG_FUNCTION_ARGS) |
||||
{ |
||||
return special_uuid_value("ns:URL"); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_ns_oid(PG_FUNCTION_ARGS) |
||||
{ |
||||
return special_uuid_value("ns:OID"); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_ns_x500(PG_FUNCTION_ARGS) |
||||
{ |
||||
return special_uuid_value("ns:X500"); |
||||
} |
||||
|
||||
|
||||
static Datum |
||||
uuid_generate_internal(int mode, const uuid_t *ns, const char *name) |
||||
{ |
||||
uuid_t *uuid; |
||||
char *str; |
||||
|
||||
uuid_create(&uuid); |
||||
uuid_make(uuid, mode, ns, name); |
||||
str = uuid_to_string(uuid); |
||||
uuid_destroy(uuid); |
||||
|
||||
return DirectFunctionCall1(uuid_in, CStringGetDatum(str)); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_generate_v1(PG_FUNCTION_ARGS) |
||||
{ |
||||
return uuid_generate_internal(UUID_MAKE_V1, NULL, NULL); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_generate_v1mc(PG_FUNCTION_ARGS) |
||||
{ |
||||
return uuid_generate_internal(UUID_MAKE_V1 | UUID_MAKE_MC, NULL, NULL); |
||||
} |
||||
|
||||
|
||||
static Datum |
||||
uuid_generate_v35_internal(int mode, pg_uuid_t *ns, text *name) |
||||
{ |
||||
uuid_t *ns_uuid; |
||||
Datum result; |
||||
|
||||
uuid_create(&ns_uuid); |
||||
string_to_uuid(DatumGetCString(DirectFunctionCall1(uuid_out, UUIDPGetDatum(ns))), |
||||
ns_uuid); |
||||
|
||||
result = uuid_generate_internal(mode, |
||||
ns_uuid, |
||||
DatumGetCString(DirectFunctionCall1(textout, PointerGetDatum(name)))); |
||||
|
||||
uuid_destroy(ns_uuid); |
||||
|
||||
return result; |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_generate_v3(PG_FUNCTION_ARGS) |
||||
{ |
||||
pg_uuid_t *ns = PG_GETARG_UUID_P(0); |
||||
text *name = PG_GETARG_TEXT_P(1); |
||||
|
||||
return uuid_generate_v35_internal(UUID_MAKE_V3, ns, name); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_generate_v4(PG_FUNCTION_ARGS) |
||||
{ |
||||
return uuid_generate_internal(UUID_MAKE_V4, NULL, NULL); |
||||
} |
||||
|
||||
|
||||
Datum |
||||
uuid_generate_v5(PG_FUNCTION_ARGS) |
||||
{ |
||||
pg_uuid_t *ns = PG_GETARG_UUID_P(0); |
||||
text *name = PG_GETARG_TEXT_P(1); |
||||
|
||||
return uuid_generate_v35_internal(UUID_MAKE_V5, ns, name); |
||||
} |
||||
@ -0,0 +1,15 @@ |
||||
/* $PostgreSQL: pgsql/contrib/uuid-ossp/uuid-ossp.sql.in,v 1.1 2007/04/21 17:26:17 petere Exp $ */ |
||||
|
||||
SET search_path = public; |
||||
|
||||
CREATE FUNCTION uuid_nil() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_nil'; |
||||
CREATE FUNCTION uuid_ns_dns() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_ns_dns'; |
||||
CREATE FUNCTION uuid_ns_url() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_ns_url'; |
||||
CREATE FUNCTION uuid_ns_oid() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_ns_oid'; |
||||
CREATE FUNCTION uuid_ns_x500() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_ns_x500'; |
||||
|
||||
CREATE FUNCTION uuid_generate_v1() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_generate_v1'; |
||||
CREATE FUNCTION uuid_generate_v1mc() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_generate_v1mc'; |
||||
CREATE FUNCTION uuid_generate_v3(namespace uuid, name text) RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_generate_v3'; |
||||
CREATE FUNCTION uuid_generate_v4() RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_generate_v4'; |
||||
CREATE FUNCTION uuid_generate_v5(namespace uuid, name text) RETURNS uuid IMMUTABLE STRICT LANGUAGE C AS 'MODULE_PATHNAME', 'uuid_generate_v5'; |
||||
Loading…
Reference in new issue