granicus.if.org Git - postgresql/blob - src/interfaces/libpq/libpq-int.h

   1 /*-------------------------------------------------------------------------
   2  *
   3  * libpq-int.h
   4  *        This file contains internal definitions meant to be used only by
   5  *        the frontend libpq library, not by applications that call it.
   6  *
   7  *        An application can include this file if it wants to bypass the
   8  *        official API defined by libpq-fe.h, but code that does so is much
   9  *        more likely to break across PostgreSQL releases than code that uses
  10  *        only the official API.
  11  *
  12  * Portions Copyright (c) 1996-2009, PostgreSQL Global Development Group
  13  * Portions Copyright (c) 1994, Regents of the University of California
  14  *
  15  * $PostgreSQL: pgsql/src/interfaces/libpq/libpq-int.h,v 1.139 2009/01/01 17:24:03 momjian Exp $
  16  *
  17  *-------------------------------------------------------------------------
  18  */
  19
  20 #ifndef LIBPQ_INT_H
  21 #define LIBPQ_INT_H
  22
  23 /* We assume libpq-fe.h has already been included. */
  24 #include "postgres_fe.h"
  25 #include "libpq-events.h"
  26
  27 #include <time.h>
  28 #include <sys/types.h>
  29 #ifndef WIN32
  30 #include <sys/time.h>
  31 #endif
  32
  33 #ifdef ENABLE_THREAD_SAFETY
  34 #ifdef WIN32
  35 #include "pthread-win32.h"
  36 #else
  37 #include <pthread.h>
  38 #endif
  39 #include <signal.h>
  40 #endif
  41
  42 /* include stuff common to fe and be */
  43 #include "getaddrinfo.h"
  44 #include "libpq/pqcomm.h"
  45 /* include stuff found in fe only */
  46 #include "pqexpbuffer.h"
  47
  48 #ifdef ENABLE_GSS
  49 #if defined(HAVE_GSSAPI_H)
  50 #include <gssapi.h>
  51 #else
  52 #include <gssapi/gssapi.h>
  53 #endif
  54 #endif
  55
  56 #ifdef ENABLE_SSPI
  57 #define SECURITY_WIN32
  58 #include <security.h>
  59 #undef SECURITY_WIN32
  60
  61 #ifndef ENABLE_GSS
  62 /*
  63  * Define a fake structure compatible with GSSAPI on Unix.
  64  */
  65 typedef struct
  66 {
  67         void       *value;
  68         int                     length;
  69 }       gss_buffer_desc;
  70 #endif
  71 #endif   /* ENABLE_SSPI */
  72
  73 #ifdef USE_SSL
  74 #include <openssl/ssl.h>
  75 #include <openssl/err.h>
  76 #endif
  77
  78 /*
  79  * POSTGRES backend dependent Constants.
  80  */
  81 #define CMDSTATUS_LEN 64                /* should match COMPLETION_TAG_BUFSIZE */
  82
  83 /*
  84  * PGresult and the subsidiary types PGresAttDesc, PGresAttValue
  85  * represent the result of a query (or more precisely, of a single SQL
  86  * command --- a query string given to PQexec can contain multiple commands).
  87  * Note we assume that a single command can return at most one tuple group,
  88  * hence there is no need for multiple descriptor sets.
  89  */
  90
  91 /* Subsidiary-storage management structure for PGresult.
  92  * See space management routines in fe-exec.c for details.
  93  * Note that space[k] refers to the k'th byte starting from the physical
  94  * head of the block --- it's a union, not a struct!
  95  */
  96 typedef union pgresult_data PGresult_data;
  97
  98 union pgresult_data
  99 {
 100         PGresult_data *next;            /* link to next block, or NULL */
 101         char            space[1];               /* dummy for accessing block as bytes */
 102 };
 103
 104 /* Data about a single parameter of a prepared statement */
 105 typedef struct pgresParamDesc
 106 {
 107         Oid                     typid;                  /* type id */
 108 } PGresParamDesc;
 109
 110 /*
 111  * Data for a single attribute of a single tuple
 112  *
 113  * We use char* for Attribute values.
 114  *
 115  * The value pointer always points to a null-terminated area; we add a
 116  * null (zero) byte after whatever the backend sends us.  This is only
 117  * particularly useful for text values ... with a binary value, the
 118  * value might have embedded nulls, so the application can't use C string
 119  * operators on it.  But we add a null anyway for consistency.
 120  * Note that the value itself does not contain a length word.
 121  *
 122  * A NULL attribute is a special case in two ways: its len field is NULL_LEN
 123  * and its value field points to null_field in the owning PGresult.  All the
 124  * NULL attributes in a query result point to the same place (there's no need
 125  * to store a null string separately for each one).
 126  */
 127
 128 #define NULL_LEN                (-1)    /* pg_result len for NULL value */
 129
 130 typedef struct pgresAttValue
 131 {
 132         int                     len;                    /* length in bytes of the value */
 133         char       *value;                      /* actual value, plus terminating zero byte */
 134 } PGresAttValue;
 135
 136 /* Typedef for message-field list entries */
 137 typedef struct pgMessageField
 138 {
 139         struct pgMessageField *next;    /* list link */
 140         char            code;                   /* field code */
 141         char            contents[1];    /* field value (VARIABLE LENGTH) */
 142 } PGMessageField;
 143
 144 /* Fields needed for notice handling */
 145 typedef struct
 146 {
 147         PQnoticeReceiver noticeRec; /* notice message receiver */
 148         void       *noticeRecArg;
 149         PQnoticeProcessor noticeProc;           /* notice message processor */
 150         void       *noticeProcArg;
 151 } PGNoticeHooks;
 152
 153 typedef struct PGEvent
 154 {
 155         PGEventProc     proc;                   /* the function to call on events */
 156         char       *name;                       /* used only for error messages */
 157         void       *passThrough;        /* pointer supplied at registration time */
 158         void       *data;                       /* optional state (instance) data */
 159         bool            resultInitialized;      /* T if RESULTCREATE/COPY succeeded */
 160 } PGEvent;
 161
 162 struct pg_result
 163 {
 164         int                     ntups;
 165         int                     numAttributes;
 166         PGresAttDesc *attDescs;
 167         PGresAttValue **tuples;         /* each PGresTuple is an array of
 168                                                                  * PGresAttValue's */
 169         int                     tupArrSize;             /* allocated size of tuples array */
 170         int                     numParameters;
 171         PGresParamDesc *paramDescs;
 172         ExecStatusType resultStatus;
 173         char            cmdStatus[CMDSTATUS_LEN];               /* cmd status from the query */
 174         int                     binary;                 /* binary tuple values if binary == 1,
 175                                                                  * otherwise text */
 176
 177         /*
 178          * These fields are copied from the originating PGconn, so that operations
 179          * on the PGresult don't have to reference the PGconn.
 180          */
 181         PGNoticeHooks noticeHooks;
 182         PGEvent    *events;
 183         int                     nEvents;
 184         int                     client_encoding;        /* encoding id */
 185
 186         /*
 187          * Error information (all NULL if not an error result).  errMsg is the
 188          * "overall" error message returned by PQresultErrorMessage.  If we have
 189          * per-field info then it is stored in a linked list.
 190          */
 191         char       *errMsg;                     /* error message, or NULL if no error */
 192         PGMessageField *errFields;      /* message broken into fields */
 193
 194         /* All NULL attributes in the query result point to this null string */
 195         char            null_field[1];
 196
 197         /*
 198          * Space management information.  Note that attDescs and error stuff, if
 199          * not null, point into allocated blocks.  But tuples points to a
 200          * separately malloc'd block, so that we can realloc it.
 201          */
 202         PGresult_data *curBlock;        /* most recently allocated block */
 203         int                     curOffset;              /* start offset of free space in block */
 204         int                     spaceLeft;              /* number of free bytes remaining in block */
 205 };
 206
 207 /* PGAsyncStatusType defines the state of the query-execution state machine */
 208 typedef enum
 209 {
 210         PGASYNC_IDLE,                           /* nothing's happening, dude */
 211         PGASYNC_BUSY,                           /* query in progress */
 212         PGASYNC_READY,                          /* result ready for PQgetResult */
 213         PGASYNC_COPY_IN,                        /* Copy In data transfer in progress */
 214         PGASYNC_COPY_OUT                        /* Copy Out data transfer in progress */
 215 } PGAsyncStatusType;
 216
 217 /* PGQueryClass tracks which query protocol we are now executing */
 218 typedef enum
 219 {
 220         PGQUERY_SIMPLE,                         /* simple Query protocol (PQexec) */
 221         PGQUERY_EXTENDED,                       /* full Extended protocol (PQexecParams) */
 222         PGQUERY_PREPARE,                        /* Parse only (PQprepare) */
 223         PGQUERY_DESCRIBE                        /* Describe Statement or Portal */
 224 } PGQueryClass;
 225
 226 /* PGSetenvStatusType defines the state of the PQSetenv state machine */
 227 /* (this is used only for 2.0-protocol connections) */
 228 typedef enum
 229 {
 230         SETENV_STATE_OPTION_SEND,       /* About to send an Environment Option */
 231         SETENV_STATE_OPTION_WAIT,       /* Waiting for above send to complete */
 232         SETENV_STATE_QUERY1_SEND,       /* About to send a status query */
 233         SETENV_STATE_QUERY1_WAIT,       /* Waiting for query to complete */
 234         SETENV_STATE_QUERY2_SEND,       /* About to send a status query */
 235         SETENV_STATE_QUERY2_WAIT,       /* Waiting for query to complete */
 236         SETENV_STATE_IDLE
 237 } PGSetenvStatusType;
 238
 239 /* Typedef for the EnvironmentOptions[] array */
 240 typedef struct PQEnvironmentOption
 241 {
 242         const char *envName,            /* name of an environment variable */
 243                            *pgName;                     /* name of corresponding SET variable */
 244 } PQEnvironmentOption;
 245
 246 /* Typedef for parameter-status list entries */
 247 typedef struct pgParameterStatus
 248 {
 249         struct pgParameterStatus *next;         /* list link */
 250         char       *name;                       /* parameter name */
 251         char       *value;                      /* parameter value */
 252         /* Note: name and value are stored in same malloc block as struct is */
 253 } pgParameterStatus;
 254
 255 /* large-object-access data ... allocated only if large-object code is used. */
 256 typedef struct pgLobjfuncs
 257 {
 258         Oid                     fn_lo_open;             /* OID of backend function lo_open              */
 259         Oid                     fn_lo_close;    /* OID of backend function lo_close             */
 260         Oid                     fn_lo_creat;    /* OID of backend function lo_creat             */
 261         Oid                     fn_lo_create;   /* OID of backend function lo_create    */
 262         Oid                     fn_lo_unlink;   /* OID of backend function lo_unlink    */
 263         Oid                     fn_lo_lseek;    /* OID of backend function lo_lseek             */
 264         Oid                     fn_lo_tell;             /* OID of backend function lo_tell              */
 265         Oid                     fn_lo_truncate; /* OID of backend function lo_truncate  */
 266         Oid                     fn_lo_read;             /* OID of backend function LOread               */
 267         Oid                     fn_lo_write;    /* OID of backend function LOwrite              */
 268 } PGlobjfuncs;
 269
 270 /*
 271  * PGconn stores all the state data associated with a single connection
 272  * to a backend.
 273  */
 274 struct pg_conn
 275 {
 276         /* Saved values of connection options */
 277         char       *pghost;                     /* the machine on which the server is running */
 278         char       *pghostaddr;         /* the IPv4 address of the machine on which
 279                                                                  * the server is running, in IPv4
 280                                                                  * numbers-and-dots notation. Takes precedence
 281                                                                  * over above. */
 282         char       *pgport;                     /* the server's communication port */
 283         char       *pgunixsocket;       /* the Unix-domain socket that the server is
 284                                                                  * listening on; if NULL, uses a default
 285                                                                  * constructed from pgport */
 286         char       *pgtty;                      /* tty on which the backend messages is
 287                                                                  * displayed (OBSOLETE, NOT USED) */
 288         char       *connect_timeout;    /* connection timeout (numeric string) */
 289         char       *pgoptions;          /* options to start the backend with */
 290         char       *dbName;                     /* database name */
 291         char       *pguser;                     /* Postgres username and password, if any */
 292         char       *pgpass;
 293         char       *sslmode;            /* SSL mode (require,prefer,allow,disable) */
 294         char       *sslverify;          /* Verify server SSL certificate (none,chain,cn) */
 295         char       *sslkey;                     /* client key filename */
 296         char       *sslcert;            /* client certificate filename */
 297         char       *sslrootcert;        /* root certificate filename */
 298         char       *sslcrl;                     /* certificate revocation list filename */
 299
 300 #if defined(KRB5) || defined(ENABLE_GSS) || defined(ENABLE_SSPI)
 301         char       *krbsrvname;         /* Kerberos service name */
 302 #endif
 303
 304         /* Optional file to write trace info to */
 305         FILE       *Pfdebug;
 306
 307         /* Callback procedures for notice message processing */
 308         PGNoticeHooks noticeHooks;
 309
 310         /* Event procs registered via PQregisterEventProc */
 311         PGEvent    *events;                     /* expandable array of event data */
 312         int                     nEvents;                /* number of active events */
 313         int                     eventArraySize; /* allocated array size */
 314
 315         /* Status indicators */
 316         ConnStatusType status;
 317         PGAsyncStatusType asyncStatus;
 318         PGTransactionStatusType xactStatus; /* never changes to ACTIVE */
 319         PGQueryClass queryclass;
 320         char       *last_query;         /* last SQL command, or NULL if unknown */
 321         bool            options_valid;  /* true if OK to attempt connection */
 322         bool            nonblocking;    /* whether this connection is using nonblock
 323                                                                  * sending semantics */
 324         char            copy_is_binary; /* 1 = copy binary, 0 = copy text */
 325         int                     copy_already_done;              /* # bytes already returned in COPY
 326                                                                                  * OUT */
 327         PGnotify   *notifyHead;         /* oldest unreported Notify msg */
 328         PGnotify   *notifyTail;         /* newest unreported Notify msg */
 329
 330         /* Connection data */
 331         int                     sock;                   /* Unix FD for socket, -1 if not connected */
 332         SockAddr        laddr;                  /* Local address */
 333         SockAddr        raddr;                  /* Remote address */
 334         ProtocolVersion pversion;       /* FE/BE protocol version in use */
 335         int                     sversion;               /* server version, e.g. 70401 for 7.4.1 */
 336         bool            password_needed;        /* true if server demanded a password */
 337
 338         /* Transient state needed while establishing connection */
 339         struct addrinfo *addrlist;      /* list of possible backend addresses */
 340         struct addrinfo *addr_cur;      /* the one currently being tried */
 341         int                     addrlist_family;        /* needed to know how to free addrlist */
 342         PGSetenvStatusType setenv_state;        /* for 2.0 protocol only */
 343         const PQEnvironmentOption *next_eo;
 344
 345         /* Miscellaneous stuff */
 346         int                     be_pid;                 /* PID of backend --- needed for cancels */
 347         int                     be_key;                 /* key of backend --- needed for cancels */
 348         char            md5Salt[4];             /* password salt received from backend */
 349         pgParameterStatus *pstatus; /* ParameterStatus data */
 350         int                     client_encoding;        /* encoding id */
 351         bool            std_strings;    /* standard_conforming_strings */
 352         PGVerbosity verbosity;          /* error/notice message verbosity */
 353         PGlobjfuncs *lobjfuncs;         /* private state for large-object access fns */
 354
 355         /* Buffer for data received from backend and not yet processed */
 356         char       *inBuffer;           /* currently allocated buffer */
 357         int                     inBufSize;              /* allocated size of buffer */
 358         int                     inStart;                /* offset to first unconsumed data in buffer */
 359         int                     inCursor;               /* next byte to tentatively consume */
 360         int                     inEnd;                  /* offset to first position after avail data */
 361
 362         /* Buffer for data not yet sent to backend */
 363         char       *outBuffer;          /* currently allocated buffer */
 364         int                     outBufSize;             /* allocated size of buffer */
 365         int                     outCount;               /* number of chars waiting in buffer */
 366
 367         /* State for constructing messages in outBuffer */
 368         int                     outMsgStart;    /* offset to msg start (length word); if -1,
 369                                                                  * msg has no length word */
 370         int                     outMsgEnd;              /* offset to msg end (so far) */
 371
 372         /* Status for asynchronous result construction */
 373         PGresult   *result;                     /* result being constructed */
 374         PGresAttValue *curTuple;        /* tuple currently being read */
 375
 376 #ifdef USE_SSL
 377         bool            allow_ssl_try;  /* Allowed to try SSL negotiation */
 378         bool            wait_ssl_try;   /* Delay SSL negotiation until after
 379                                                                  * attempting normal connection */
 380         SSL                *ssl;                        /* SSL status, if have SSL connection */
 381         X509       *peer;                       /* X509 cert of server */
 382         char            peer_dn[256 + 1];               /* peer distinguished name */
 383         char            peer_cn[SM_USER + 1];   /* peer common name */
 384 #endif
 385
 386 #ifdef ENABLE_GSS
 387         gss_ctx_id_t gctx;                      /* GSS context */
 388         gss_name_t      gtarg_nam;              /* GSS target name */
 389         gss_buffer_desc ginbuf;         /* GSS input token */
 390         gss_buffer_desc goutbuf;        /* GSS output token */
 391 #endif
 392
 393 #ifdef ENABLE_SSPI
 394 #ifndef ENABLE_GSS
 395         gss_buffer_desc ginbuf;         /* GSS input token */
 396 #else
 397         char       *gsslib;                     /* What GSS librart to use ("gssapi" or
 398                                                                  * "sspi") */
 399 #endif
 400         CredHandle *sspicred;           /* SSPI credentials handle */
 401         CtxtHandle *sspictx;            /* SSPI context */
 402         char       *sspitarget;         /* SSPI target name */
 403         int                     usesspi;                /* Indicate if SSPI is in use on the
 404                                                                  * connection */
 405 #endif
 406
 407
 408         /* Buffer for current error message */
 409         PQExpBufferData errorMessage;           /* expansible string */
 410
 411         /* Buffer for receiving various parts of messages */
 412         PQExpBufferData workBuffer; /* expansible string */
 413 };
 414
 415 /* PGcancel stores all data necessary to cancel a connection. A copy of this
 416  * data is required to safely cancel a connection running on a different
 417  * thread.
 418  */
 419 struct pg_cancel
 420 {
 421         SockAddr        raddr;                  /* Remote address */
 422         int                     be_pid;                 /* PID of backend --- needed for cancels */
 423         int                     be_key;                 /* key of backend --- needed for cancels */
 424 };
 425
 426
 427 /* String descriptions of the ExecStatusTypes.
 428  * direct use of this array is deprecated; call PQresStatus() instead.
 429  */
 430 extern char *const pgresStatus[];
 431
 432 /* ----------------
 433  * Internal functions of libpq
 434  * Functions declared here need to be visible across files of libpq,
 435  * but are not intended to be called by applications.  We use the
 436  * convention "pqXXX" for internal functions, vs. the "PQxxx" names
 437  * used for application-visible routines.
 438  * ----------------
 439  */
 440
 441 /* === in fe-connect.c === */
 442
 443 extern int pqPacketSend(PGconn *conn, char pack_type,
 444                          const void *buf, size_t buf_len);
 445 extern bool pqGetHomeDirectory(char *buf, int bufsize);
 446
 447 #ifdef ENABLE_THREAD_SAFETY
 448 extern pgthreadlock_t pg_g_threadlock;
 449
 450 #define PGTHREAD_ERROR(msg) \
 451         do { \
 452                 fprintf(stderr, "%s\n", msg); \
 453                 exit(1); \
 454         } while (0)
 455
 456
 457 #define pglock_thread()         pg_g_threadlock(true)
 458 #define pgunlock_thread()       pg_g_threadlock(false)
 459 #else
 460 #define pglock_thread()         ((void) 0)
 461 #define pgunlock_thread()       ((void) 0)
 462 #endif
 463
 464 /* === in fe-exec.c === */
 465
 466 extern void pqSetResultError(PGresult *res, const char *msg);
 467 extern void pqCatenateResultError(PGresult *res, const char *msg);
 468 extern void *pqResultAlloc(PGresult *res, size_t nBytes, bool isBinary);
 469 extern char *pqResultStrdup(PGresult *res, const char *str);
 470 extern void pqClearAsyncResult(PGconn *conn);
 471 extern void pqSaveErrorResult(PGconn *conn);
 472 extern PGresult *pqPrepareAsyncResult(PGconn *conn);
 473 extern void
 474 pqInternalNotice(const PGNoticeHooks *hooks, const char *fmt,...)
 475 /* This lets gcc check the format string for consistency. */
 476 __attribute__((format(printf, 2, 3)));
 477 extern int      pqAddTuple(PGresult *res, PGresAttValue *tup);
 478 extern void pqSaveMessageField(PGresult *res, char code,
 479                                    const char *value);
 480 extern void pqSaveParameterStatus(PGconn *conn, const char *name,
 481                                           const char *value);
 482 extern void pqHandleSendFailure(PGconn *conn);
 483
 484 /* === in fe-protocol2.c === */
 485
 486 extern PostgresPollingStatusType pqSetenvPoll(PGconn *conn);
 487
 488 extern char *pqBuildStartupPacket2(PGconn *conn, int *packetlen,
 489                                           const PQEnvironmentOption *options);
 490 extern void pqParseInput2(PGconn *conn);
 491 extern int      pqGetCopyData2(PGconn *conn, char **buffer, int async);
 492 extern int      pqGetline2(PGconn *conn, char *s, int maxlen);
 493 extern int      pqGetlineAsync2(PGconn *conn, char *buffer, int bufsize);
 494 extern int      pqEndcopy2(PGconn *conn);
 495 extern PGresult *pqFunctionCall2(PGconn *conn, Oid fnid,
 496                                 int *result_buf, int *actual_result_len,
 497                                 int result_is_int,
 498                                 const PQArgBlock *args, int nargs);
 499
 500 /* === in fe-protocol3.c === */
 501
 502 extern char *pqBuildStartupPacket3(PGconn *conn, int *packetlen,
 503                                           const PQEnvironmentOption *options);
 504 extern void pqParseInput3(PGconn *conn);
 505 extern int      pqGetErrorNotice3(PGconn *conn, bool isError);
 506 extern int      pqGetCopyData3(PGconn *conn, char **buffer, int async);
 507 extern int      pqGetline3(PGconn *conn, char *s, int maxlen);
 508 extern int      pqGetlineAsync3(PGconn *conn, char *buffer, int bufsize);
 509 extern int      pqEndcopy3(PGconn *conn);
 510 extern PGresult *pqFunctionCall3(PGconn *conn, Oid fnid,
 511                                 int *result_buf, int *actual_result_len,
 512                                 int result_is_int,
 513                                 const PQArgBlock *args, int nargs);
 514
 515 /* === in fe-misc.c === */
 516
 517  /*
 518   * "Get" and "Put" routines return 0 if successful, EOF if not. Note that for
 519   * Get, EOF merely means the buffer is exhausted, not that there is
 520   * necessarily any error.
 521   */
 522 extern int      pqCheckOutBufferSpace(size_t bytes_needed, PGconn *conn);
 523 extern int      pqCheckInBufferSpace(size_t bytes_needed, PGconn *conn);
 524 extern int      pqGetc(char *result, PGconn *conn);
 525 extern int      pqPutc(char c, PGconn *conn);
 526 extern int      pqGets(PQExpBuffer buf, PGconn *conn);
 527 extern int      pqGets_append(PQExpBuffer buf, PGconn *conn);
 528 extern int      pqPuts(const char *s, PGconn *conn);
 529 extern int      pqGetnchar(char *s, size_t len, PGconn *conn);
 530 extern int      pqPutnchar(const char *s, size_t len, PGconn *conn);
 531 extern int      pqGetInt(int *result, size_t bytes, PGconn *conn);
 532 extern int      pqPutInt(int value, size_t bytes, PGconn *conn);
 533 extern int      pqPutMsgStart(char msg_type, bool force_len, PGconn *conn);
 534 extern int      pqPutMsgEnd(PGconn *conn);
 535 extern int      pqReadData(PGconn *conn);
 536 extern int      pqFlush(PGconn *conn);
 537 extern int      pqWait(int forRead, int forWrite, PGconn *conn);
 538 extern int pqWaitTimed(int forRead, int forWrite, PGconn *conn,
 539                         time_t finish_time);
 540 extern int      pqReadReady(PGconn *conn);
 541 extern int      pqWriteReady(PGconn *conn);
 542
 543 /* === in fe-secure.c === */
 544
 545 extern int      pqsecure_initialize(PGconn *);
 546 extern void pqsecure_destroy(void);
 547 extern PostgresPollingStatusType pqsecure_open_client(PGconn *);
 548 extern void pqsecure_close(PGconn *);
 549 extern ssize_t pqsecure_read(PGconn *, void *ptr, size_t len);
 550 extern ssize_t pqsecure_write(PGconn *, const void *ptr, size_t len);
 551
 552 #if defined(ENABLE_THREAD_SAFETY) && !defined(WIN32)
 553 extern int      pq_block_sigpipe(sigset_t *osigset, bool *sigpipe_pending);
 554 extern void pq_reset_sigpipe(sigset_t *osigset, bool sigpipe_pending,
 555                                  bool got_epipe);
 556 #endif
 557
 558 /*
 559  * this is so that we can check if a connection is non-blocking internally
 560  * without the overhead of a function call
 561  */
 562 #define pqIsnonblocking(conn)   ((conn)->nonblocking)
 563
 564 #ifdef ENABLE_NLS
 565 extern char *
 566 libpq_gettext(const char *msgid)
 567 __attribute__((format_arg(1)));
 568 #else
 569 #define libpq_gettext(x) (x)
 570 #endif
 571
 572 /*
 573  * These macros are needed to let error-handling code be portable between
 574  * Unix and Windows.  (ugh)
 575  */
 576 #ifdef WIN32
 577 #define SOCK_ERRNO (WSAGetLastError())
 578 #define SOCK_STRERROR winsock_strerror
 579 #define SOCK_ERRNO_SET(e) WSASetLastError(e)
 580 #else
 581 #define SOCK_ERRNO errno
 582 #define SOCK_STRERROR pqStrerror
 583 #define SOCK_ERRNO_SET(e) (errno = (e))
 584 #endif
 585
 586 #endif   /* LIBPQ_INT_H */