Line data Source code
1 : /*-------------------------------------------------------------------------
2 : *
3 : * copyto.c
4 : * COPY <table> TO file/program/client
5 : *
6 : * Portions Copyright (c) 1996-2024, PostgreSQL Global Development Group
7 : * Portions Copyright (c) 1994, Regents of the University of California
8 : *
9 : *
10 : * IDENTIFICATION
11 : * src/backend/commands/copyto.c
12 : *
13 : *-------------------------------------------------------------------------
14 : */
15 : #include "postgres.h"
16 :
17 : #include <ctype.h>
18 : #include <unistd.h>
19 : #include <sys/stat.h>
20 :
21 : #include "access/tableam.h"
22 : #include "commands/copy.h"
23 : #include "commands/progress.h"
24 : #include "executor/execdesc.h"
25 : #include "executor/executor.h"
26 : #include "executor/tuptable.h"
27 : #include "libpq/libpq.h"
28 : #include "libpq/pqformat.h"
29 : #include "mb/pg_wchar.h"
30 : #include "miscadmin.h"
31 : #include "pgstat.h"
32 : #include "storage/fd.h"
33 : #include "tcop/tcopprot.h"
34 : #include "utils/lsyscache.h"
35 : #include "utils/memutils.h"
36 : #include "utils/rel.h"
37 : #include "utils/snapmgr.h"
38 :
39 : /*
40 : * Represents the different dest cases we need to worry about at
41 : * the bottom level
42 : */
43 : typedef enum CopyDest
44 : {
45 : COPY_FILE, /* to file (or a piped program) */
46 : COPY_FRONTEND, /* to frontend */
47 : COPY_CALLBACK, /* to callback function */
48 : } CopyDest;
49 :
50 : /*
51 : * This struct contains all the state variables used throughout a COPY TO
52 : * operation.
53 : *
54 : * Multi-byte encodings: all supported client-side encodings encode multi-byte
55 : * characters by having the first byte's high bit set. Subsequent bytes of the
56 : * character can have the high bit not set. When scanning data in such an
57 : * encoding to look for a match to a single-byte (ie ASCII) character, we must
58 : * use the full pg_encoding_mblen() machinery to skip over multibyte
59 : * characters, else we might find a false match to a trailing byte. In
60 : * supported server encodings, there is no possibility of a false match, and
61 : * it's faster to make useless comparisons to trailing bytes than it is to
62 : * invoke pg_encoding_mblen() to skip over them. encoding_embeds_ascii is true
63 : * when we have to do it the hard way.
64 : */
65 : typedef struct CopyToStateData
66 : {
67 : /* low-level state data */
68 : CopyDest copy_dest; /* type of copy source/destination */
69 : FILE *copy_file; /* used if copy_dest == COPY_FILE */
70 : StringInfo fe_msgbuf; /* used for all dests during COPY TO */
71 :
72 : int file_encoding; /* file or remote side's character encoding */
73 : bool need_transcoding; /* file encoding diff from server? */
74 : bool encoding_embeds_ascii; /* ASCII can be non-first byte? */
75 :
76 : /* parameters from the COPY command */
77 : Relation rel; /* relation to copy to */
78 : QueryDesc *queryDesc; /* executable query to copy from */
79 : List *attnumlist; /* integer list of attnums to copy */
80 : char *filename; /* filename, or NULL for STDOUT */
81 : bool is_program; /* is 'filename' a program to popen? */
82 : copy_data_dest_cb data_dest_cb; /* function for writing data */
83 :
84 : CopyFormatOptions opts;
85 : Node *whereClause; /* WHERE condition (or NULL) */
86 :
87 : /*
88 : * Working state
89 : */
90 : MemoryContext copycontext; /* per-copy execution context */
91 :
92 : FmgrInfo *out_functions; /* lookup info for output functions */
93 : MemoryContext rowcontext; /* per-row evaluation context */
94 : uint64 bytes_processed; /* number of bytes processed so far */
95 : } CopyToStateData;
96 :
97 : /* DestReceiver for COPY (query) TO */
98 : typedef struct
99 : {
100 : DestReceiver pub; /* publicly-known function pointers */
101 : CopyToState cstate; /* CopyToStateData for the command */
102 : uint64 processed; /* # of tuples processed */
103 : } DR_copy;
104 :
105 : /* NOTE: there's a copy of this in copyfromparse.c */
106 : static const char BinarySignature[11] = "PGCOPY\n\377\r\n\0";
107 :
108 :
109 : /* non-export function prototypes */
110 : static void EndCopy(CopyToState cstate);
111 : static void ClosePipeToProgram(CopyToState cstate);
112 : static void CopyOneRowTo(CopyToState cstate, TupleTableSlot *slot);
113 : static void CopyAttributeOutText(CopyToState cstate, const char *string);
114 : static void CopyAttributeOutCSV(CopyToState cstate, const char *string,
115 : bool use_quote);
116 :
117 : /* Low-level communications functions */
118 : static void SendCopyBegin(CopyToState cstate);
119 : static void SendCopyEnd(CopyToState cstate);
120 : static void CopySendData(CopyToState cstate, const void *databuf, int datasize);
121 : static void CopySendString(CopyToState cstate, const char *str);
122 : static void CopySendChar(CopyToState cstate, char c);
123 : static void CopySendEndOfRow(CopyToState cstate);
124 : static void CopySendInt32(CopyToState cstate, int32 val);
125 : static void CopySendInt16(CopyToState cstate, int16 val);
126 :
127 :
128 : /*
129 : * Send copy start/stop messages for frontend copies. These have changed
130 : * in past protocol redesigns.
131 : */
132 : static void
133 7882 : SendCopyBegin(CopyToState cstate)
134 : {
135 : StringInfoData buf;
136 7882 : int natts = list_length(cstate->attnumlist);
137 7882 : int16 format = (cstate->opts.binary ? 1 : 0);
138 : int i;
139 :
140 7882 : pq_beginmessage(&buf, PqMsg_CopyOutResponse);
141 7882 : pq_sendbyte(&buf, format); /* overall format */
142 7882 : pq_sendint16(&buf, natts);
143 37228 : for (i = 0; i < natts; i++)
144 29346 : pq_sendint16(&buf, format); /* per-column formats */
145 7882 : pq_endmessage(&buf);
146 7882 : cstate->copy_dest = COPY_FRONTEND;
147 7882 : }
148 :
149 : static void
150 7880 : SendCopyEnd(CopyToState cstate)
151 : {
152 : /* Shouldn't have any unsent data */
153 : Assert(cstate->fe_msgbuf->len == 0);
154 : /* Send Copy Done message */
155 7880 : pq_putemptymessage(PqMsg_CopyDone);
156 7880 : }
157 :
158 : /*----------
159 : * CopySendData sends output data to the destination (file or frontend)
160 : * CopySendString does the same for null-terminated strings
161 : * CopySendChar does the same for single characters
162 : * CopySendEndOfRow does the appropriate thing at end of each data row
163 : * (data is not actually flushed except by CopySendEndOfRow)
164 : *
165 : * NB: no data conversion is applied by these functions
166 : *----------
167 : */
168 : static void
169 12613986 : CopySendData(CopyToState cstate, const void *databuf, int datasize)
170 : {
171 12613986 : appendBinaryStringInfo(cstate->fe_msgbuf, databuf, datasize);
172 12613986 : }
173 :
174 : static void
175 1155776 : CopySendString(CopyToState cstate, const char *str)
176 : {
177 1155776 : appendBinaryStringInfo(cstate->fe_msgbuf, str, strlen(str));
178 1155776 : }
179 :
180 : static void
181 13991150 : CopySendChar(CopyToState cstate, char c)
182 : {
183 13991150 : appendStringInfoCharMacro(cstate->fe_msgbuf, c);
184 13991150 : }
185 :
186 : static void
187 3636290 : CopySendEndOfRow(CopyToState cstate)
188 : {
189 3636290 : StringInfo fe_msgbuf = cstate->fe_msgbuf;
190 :
191 3636290 : switch (cstate->copy_dest)
192 : {
193 12258 : case COPY_FILE:
194 12258 : if (!cstate->opts.binary)
195 : {
196 : /* Default line termination depends on platform */
197 : #ifndef WIN32
198 12234 : CopySendChar(cstate, '\n');
199 : #else
200 : CopySendString(cstate, "\r\n");
201 : #endif
202 : }
203 :
204 12258 : if (fwrite(fe_msgbuf->data, fe_msgbuf->len, 1,
205 12258 : cstate->copy_file) != 1 ||
206 12258 : ferror(cstate->copy_file))
207 : {
208 0 : if (cstate->is_program)
209 : {
210 0 : if (errno == EPIPE)
211 : {
212 : /*
213 : * The pipe will be closed automatically on error at
214 : * the end of transaction, but we might get a better
215 : * error message from the subprocess' exit code than
216 : * just "Broken Pipe"
217 : */
218 0 : ClosePipeToProgram(cstate);
219 :
220 : /*
221 : * If ClosePipeToProgram() didn't throw an error, the
222 : * program terminated normally, but closed the pipe
223 : * first. Restore errno, and throw an error.
224 : */
225 0 : errno = EPIPE;
226 : }
227 0 : ereport(ERROR,
228 : (errcode_for_file_access(),
229 : errmsg("could not write to COPY program: %m")));
230 : }
231 : else
232 0 : ereport(ERROR,
233 : (errcode_for_file_access(),
234 : errmsg("could not write to COPY file: %m")));
235 : }
236 12258 : break;
237 3624026 : case COPY_FRONTEND:
238 : /* The FE/BE protocol uses \n as newline for all platforms */
239 3624026 : if (!cstate->opts.binary)
240 3624004 : CopySendChar(cstate, '\n');
241 :
242 : /* Dump the accumulated row as one CopyData message */
243 3624026 : (void) pq_putmessage(PqMsg_CopyData, fe_msgbuf->data, fe_msgbuf->len);
244 3624026 : break;
245 6 : case COPY_CALLBACK:
246 6 : cstate->data_dest_cb(fe_msgbuf->data, fe_msgbuf->len);
247 6 : break;
248 : }
249 :
250 : /* Update the progress */
251 3636290 : cstate->bytes_processed += fe_msgbuf->len;
252 3636290 : pgstat_progress_update_param(PROGRESS_COPY_BYTES_PROCESSED, cstate->bytes_processed);
253 :
254 3636290 : resetStringInfo(fe_msgbuf);
255 3636290 : }
256 :
257 : /*
258 : * These functions do apply some data conversion
259 : */
260 :
261 : /*
262 : * CopySendInt32 sends an int32 in network byte order
263 : */
264 : static inline void
265 188 : CopySendInt32(CopyToState cstate, int32 val)
266 : {
267 : uint32 buf;
268 :
269 188 : buf = pg_hton32((uint32) val);
270 188 : CopySendData(cstate, &buf, sizeof(buf));
271 188 : }
272 :
273 : /*
274 : * CopySendInt16 sends an int16 in network byte order
275 : */
276 : static inline void
277 46 : CopySendInt16(CopyToState cstate, int16 val)
278 : {
279 : uint16 buf;
280 :
281 46 : buf = pg_hton16((uint16) val);
282 46 : CopySendData(cstate, &buf, sizeof(buf));
283 46 : }
284 :
285 : /*
286 : * Closes the pipe to an external program, checking the pclose() return code.
287 : */
288 : static void
289 0 : ClosePipeToProgram(CopyToState cstate)
290 : {
291 : int pclose_rc;
292 :
293 : Assert(cstate->is_program);
294 :
295 0 : pclose_rc = ClosePipeStream(cstate->copy_file);
296 0 : if (pclose_rc == -1)
297 0 : ereport(ERROR,
298 : (errcode_for_file_access(),
299 : errmsg("could not close pipe to external command: %m")));
300 0 : else if (pclose_rc != 0)
301 : {
302 0 : ereport(ERROR,
303 : (errcode(ERRCODE_EXTERNAL_ROUTINE_EXCEPTION),
304 : errmsg("program \"%s\" failed",
305 : cstate->filename),
306 : errdetail_internal("%s", wait_result_to_str(pclose_rc))));
307 : }
308 0 : }
309 :
310 : /*
311 : * Release resources allocated in a cstate for COPY TO/FROM.
312 : */
313 : static void
314 7920 : EndCopy(CopyToState cstate)
315 : {
316 7920 : if (cstate->is_program)
317 : {
318 0 : ClosePipeToProgram(cstate);
319 : }
320 : else
321 : {
322 7920 : if (cstate->filename != NULL && FreeFile(cstate->copy_file))
323 0 : ereport(ERROR,
324 : (errcode_for_file_access(),
325 : errmsg("could not close file \"%s\": %m",
326 : cstate->filename)));
327 : }
328 :
329 7920 : pgstat_progress_end_command();
330 :
331 7920 : MemoryContextDelete(cstate->copycontext);
332 7920 : pfree(cstate);
333 7920 : }
334 :
335 : /*
336 : * Setup CopyToState to read tuples from a table or a query for COPY TO.
337 : *
338 : * 'rel': Relation to be copied
339 : * 'raw_query': Query whose results are to be copied
340 : * 'queryRelId': OID of base relation to convert to a query (for RLS)
341 : * 'filename': Name of server-local file to write, NULL for STDOUT
342 : * 'is_program': true if 'filename' is program to execute
343 : * 'data_dest_cb': Callback that processes the output data
344 : * 'attnamelist': List of char *, columns to include. NIL selects all cols.
345 : * 'options': List of DefElem. See copy_opt_item in gram.y for selections.
346 : *
347 : * Returns a CopyToState, to be passed to DoCopyTo() and related functions.
348 : */
349 : CopyToState
350 8110 : BeginCopyTo(ParseState *pstate,
351 : Relation rel,
352 : RawStmt *raw_query,
353 : Oid queryRelId,
354 : const char *filename,
355 : bool is_program,
356 : copy_data_dest_cb data_dest_cb,
357 : List *attnamelist,
358 : List *options)
359 : {
360 : CopyToState cstate;
361 8110 : bool pipe = (filename == NULL && data_dest_cb == NULL);
362 : TupleDesc tupDesc;
363 : int num_phys_attrs;
364 : MemoryContext oldcontext;
365 8110 : const int progress_cols[] = {
366 : PROGRESS_COPY_COMMAND,
367 : PROGRESS_COPY_TYPE
368 : };
369 8110 : int64 progress_vals[] = {
370 : PROGRESS_COPY_COMMAND_TO,
371 : 0
372 : };
373 :
374 8110 : if (rel != NULL && rel->rd_rel->relkind != RELKIND_RELATION)
375 : {
376 12 : if (rel->rd_rel->relkind == RELKIND_VIEW)
377 12 : ereport(ERROR,
378 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
379 : errmsg("cannot copy from view \"%s\"",
380 : RelationGetRelationName(rel)),
381 : errhint("Try the COPY (SELECT ...) TO variant.")));
382 0 : else if (rel->rd_rel->relkind == RELKIND_MATVIEW)
383 0 : ereport(ERROR,
384 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
385 : errmsg("cannot copy from materialized view \"%s\"",
386 : RelationGetRelationName(rel)),
387 : errhint("Try the COPY (SELECT ...) TO variant.")));
388 0 : else if (rel->rd_rel->relkind == RELKIND_FOREIGN_TABLE)
389 0 : ereport(ERROR,
390 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
391 : errmsg("cannot copy from foreign table \"%s\"",
392 : RelationGetRelationName(rel)),
393 : errhint("Try the COPY (SELECT ...) TO variant.")));
394 0 : else if (rel->rd_rel->relkind == RELKIND_SEQUENCE)
395 0 : ereport(ERROR,
396 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
397 : errmsg("cannot copy from sequence \"%s\"",
398 : RelationGetRelationName(rel))));
399 0 : else if (rel->rd_rel->relkind == RELKIND_PARTITIONED_TABLE)
400 0 : ereport(ERROR,
401 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
402 : errmsg("cannot copy from partitioned table \"%s\"",
403 : RelationGetRelationName(rel)),
404 : errhint("Try the COPY (SELECT ...) TO variant.")));
405 : else
406 0 : ereport(ERROR,
407 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
408 : errmsg("cannot copy from non-table relation \"%s\"",
409 : RelationGetRelationName(rel))));
410 : }
411 :
412 :
413 : /* Allocate workspace and zero all fields */
414 8098 : cstate = (CopyToStateData *) palloc0(sizeof(CopyToStateData));
415 :
416 : /*
417 : * We allocate everything used by a cstate in a new memory context. This
418 : * avoids memory leaks during repeated use of COPY in a query.
419 : */
420 8098 : cstate->copycontext = AllocSetContextCreate(CurrentMemoryContext,
421 : "COPY",
422 : ALLOCSET_DEFAULT_SIZES);
423 :
424 8098 : oldcontext = MemoryContextSwitchTo(cstate->copycontext);
425 :
426 : /* Extract options from the statement node tree */
427 8098 : ProcessCopyOptions(pstate, &cstate->opts, false /* is_from */ , options);
428 :
429 : /* Process the source/target relation or query */
430 8056 : if (rel)
431 : {
432 : Assert(!raw_query);
433 :
434 7578 : cstate->rel = rel;
435 :
436 7578 : tupDesc = RelationGetDescr(cstate->rel);
437 : }
438 : else
439 : {
440 : List *rewritten;
441 : Query *query;
442 : PlannedStmt *plan;
443 : DestReceiver *dest;
444 :
445 478 : cstate->rel = NULL;
446 :
447 : /*
448 : * Run parse analysis and rewrite. Note this also acquires sufficient
449 : * locks on the source table(s).
450 : */
451 478 : rewritten = pg_analyze_and_rewrite_fixedparams(raw_query,
452 : pstate->p_sourcetext, NULL, 0,
453 : NULL);
454 :
455 : /* check that we got back something we can work with */
456 466 : if (rewritten == NIL)
457 : {
458 18 : ereport(ERROR,
459 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
460 : errmsg("DO INSTEAD NOTHING rules are not supported for COPY")));
461 : }
462 448 : else if (list_length(rewritten) > 1)
463 : {
464 : ListCell *lc;
465 :
466 : /* examine queries to determine which error message to issue */
467 102 : foreach(lc, rewritten)
468 : {
469 84 : Query *q = lfirst_node(Query, lc);
470 :
471 84 : if (q->querySource == QSRC_QUAL_INSTEAD_RULE)
472 18 : ereport(ERROR,
473 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
474 : errmsg("conditional DO INSTEAD rules are not supported for COPY")));
475 66 : if (q->querySource == QSRC_NON_INSTEAD_RULE)
476 18 : ereport(ERROR,
477 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
478 : errmsg("DO ALSO rules are not supported for COPY")));
479 : }
480 :
481 18 : ereport(ERROR,
482 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
483 : errmsg("multi-statement DO INSTEAD rules are not supported for COPY")));
484 : }
485 :
486 394 : query = linitial_node(Query, rewritten);
487 :
488 : /* The grammar allows SELECT INTO, but we don't support that */
489 394 : if (query->utilityStmt != NULL &&
490 18 : IsA(query->utilityStmt, CreateTableAsStmt))
491 12 : ereport(ERROR,
492 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
493 : errmsg("COPY (SELECT INTO) is not supported")));
494 :
495 : /* The only other utility command we could see is NOTIFY */
496 382 : if (query->utilityStmt != NULL)
497 6 : ereport(ERROR,
498 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
499 : errmsg("COPY query must not be a utility command")));
500 :
501 : /*
502 : * Similarly the grammar doesn't enforce the presence of a RETURNING
503 : * clause, but this is required here.
504 : */
505 376 : if (query->commandType != CMD_SELECT &&
506 110 : query->returningList == NIL)
507 : {
508 : Assert(query->commandType == CMD_INSERT ||
509 : query->commandType == CMD_UPDATE ||
510 : query->commandType == CMD_DELETE ||
511 : query->commandType == CMD_MERGE);
512 :
513 24 : ereport(ERROR,
514 : (errcode(ERRCODE_FEATURE_NOT_SUPPORTED),
515 : errmsg("COPY query must have a RETURNING clause")));
516 : }
517 :
518 : /* plan the query */
519 352 : plan = pg_plan_query(query, pstate->p_sourcetext,
520 : CURSOR_OPT_PARALLEL_OK, NULL);
521 :
522 : /*
523 : * With row-level security and a user using "COPY relation TO", we
524 : * have to convert the "COPY relation TO" to a query-based COPY (eg:
525 : * "COPY (SELECT * FROM ONLY relation) TO"), to allow the rewriter to
526 : * add in any RLS clauses.
527 : *
528 : * When this happens, we are passed in the relid of the originally
529 : * found relation (which we have locked). As the planner will look up
530 : * the relation again, we double-check here to make sure it found the
531 : * same one that we have locked.
532 : */
533 350 : if (queryRelId != InvalidOid)
534 : {
535 : /*
536 : * Note that with RLS involved there may be multiple relations,
537 : * and while the one we need is almost certainly first, we don't
538 : * make any guarantees of that in the planner, so check the whole
539 : * list and make sure we find the original relation.
540 : */
541 54 : if (!list_member_oid(plan->relationOids, queryRelId))
542 0 : ereport(ERROR,
543 : (errcode(ERRCODE_OBJECT_NOT_IN_PREREQUISITE_STATE),
544 : errmsg("relation referenced by COPY statement has changed")));
545 : }
546 :
547 : /*
548 : * Use a snapshot with an updated command ID to ensure this query sees
549 : * results of any previously executed queries.
550 : */
551 350 : PushCopiedSnapshot(GetActiveSnapshot());
552 350 : UpdateActiveSnapshotCommandId();
553 :
554 : /* Create dest receiver for COPY OUT */
555 350 : dest = CreateDestReceiver(DestCopyOut);
556 350 : ((DR_copy *) dest)->cstate = cstate;
557 :
558 : /* Create a QueryDesc requesting no output */
559 350 : cstate->queryDesc = CreateQueryDesc(plan, pstate->p_sourcetext,
560 : GetActiveSnapshot(),
561 : InvalidSnapshot,
562 : dest, NULL, NULL, 0);
563 :
564 : /*
565 : * Call ExecutorStart to prepare the plan for execution.
566 : *
567 : * ExecutorStart computes a result tupdesc for us
568 : */
569 350 : ExecutorStart(cstate->queryDesc, 0);
570 :
571 344 : tupDesc = cstate->queryDesc->tupDesc;
572 : }
573 :
574 : /* Generate or convert list of attributes to process */
575 7922 : cstate->attnumlist = CopyGetAttnums(tupDesc, cstate->rel, attnamelist);
576 :
577 7922 : num_phys_attrs = tupDesc->natts;
578 :
579 : /* Convert FORCE_QUOTE name list to per-column flags, check validity */
580 7922 : cstate->opts.force_quote_flags = (bool *) palloc0(num_phys_attrs * sizeof(bool));
581 7922 : if (cstate->opts.force_quote_all)
582 : {
583 18 : MemSet(cstate->opts.force_quote_flags, true, num_phys_attrs * sizeof(bool));
584 : }
585 7904 : else if (cstate->opts.force_quote)
586 : {
587 : List *attnums;
588 : ListCell *cur;
589 :
590 24 : attnums = CopyGetAttnums(tupDesc, cstate->rel, cstate->opts.force_quote);
591 :
592 48 : foreach(cur, attnums)
593 : {
594 24 : int attnum = lfirst_int(cur);
595 24 : Form_pg_attribute attr = TupleDescAttr(tupDesc, attnum - 1);
596 :
597 24 : if (!list_member_int(cstate->attnumlist, attnum))
598 0 : ereport(ERROR,
599 : (errcode(ERRCODE_INVALID_COLUMN_REFERENCE),
600 : /*- translator: %s is the name of a COPY option, e.g. FORCE_NOT_NULL */
601 : errmsg("%s column \"%s\" not referenced by COPY",
602 : "FORCE_QUOTE", NameStr(attr->attname))));
603 24 : cstate->opts.force_quote_flags[attnum - 1] = true;
604 : }
605 : }
606 :
607 : /* Use client encoding when ENCODING option is not specified. */
608 7922 : if (cstate->opts.file_encoding < 0)
609 7916 : cstate->file_encoding = pg_get_client_encoding();
610 : else
611 6 : cstate->file_encoding = cstate->opts.file_encoding;
612 :
613 : /*
614 : * Set up encoding conversion info if the file and server encodings differ
615 : * (see also pg_server_to_any).
616 : */
617 7922 : if (cstate->file_encoding == GetDatabaseEncoding() ||
618 8 : cstate->file_encoding == PG_SQL_ASCII)
619 7920 : cstate->need_transcoding = false;
620 : else
621 2 : cstate->need_transcoding = true;
622 :
623 : /* See Multibyte encoding comment above */
624 7922 : cstate->encoding_embeds_ascii = PG_ENCODING_IS_CLIENT_ONLY(cstate->file_encoding);
625 :
626 7922 : cstate->copy_dest = COPY_FILE; /* default */
627 :
628 7922 : if (data_dest_cb)
629 : {
630 2 : progress_vals[1] = PROGRESS_COPY_TYPE_CALLBACK;
631 2 : cstate->copy_dest = COPY_CALLBACK;
632 2 : cstate->data_dest_cb = data_dest_cb;
633 : }
634 7920 : else if (pipe)
635 : {
636 7882 : progress_vals[1] = PROGRESS_COPY_TYPE_PIPE;
637 :
638 : Assert(!is_program); /* the grammar does not allow this */
639 7882 : if (whereToSendOutput != DestRemote)
640 0 : cstate->copy_file = stdout;
641 : }
642 : else
643 : {
644 38 : cstate->filename = pstrdup(filename);
645 38 : cstate->is_program = is_program;
646 :
647 38 : if (is_program)
648 : {
649 0 : progress_vals[1] = PROGRESS_COPY_TYPE_PROGRAM;
650 0 : cstate->copy_file = OpenPipeStream(cstate->filename, PG_BINARY_W);
651 0 : if (cstate->copy_file == NULL)
652 0 : ereport(ERROR,
653 : (errcode_for_file_access(),
654 : errmsg("could not execute command \"%s\": %m",
655 : cstate->filename)));
656 : }
657 : else
658 : {
659 : mode_t oumask; /* Pre-existing umask value */
660 : struct stat st;
661 :
662 38 : progress_vals[1] = PROGRESS_COPY_TYPE_FILE;
663 :
664 : /*
665 : * Prevent write to relative path ... too easy to shoot oneself in
666 : * the foot by overwriting a database file ...
667 : */
668 38 : if (!is_absolute_path(filename))
669 0 : ereport(ERROR,
670 : (errcode(ERRCODE_INVALID_NAME),
671 : errmsg("relative path not allowed for COPY to file")));
672 :
673 38 : oumask = umask(S_IWGRP | S_IWOTH);
674 38 : PG_TRY();
675 : {
676 38 : cstate->copy_file = AllocateFile(cstate->filename, PG_BINARY_W);
677 : }
678 0 : PG_FINALLY();
679 : {
680 38 : umask(oumask);
681 : }
682 38 : PG_END_TRY();
683 38 : if (cstate->copy_file == NULL)
684 : {
685 : /* copy errno because ereport subfunctions might change it */
686 0 : int save_errno = errno;
687 :
688 0 : ereport(ERROR,
689 : (errcode_for_file_access(),
690 : errmsg("could not open file \"%s\" for writing: %m",
691 : cstate->filename),
692 : (save_errno == ENOENT || save_errno == EACCES) ?
693 : errhint("COPY TO instructs the PostgreSQL server process to write a file. "
694 : "You may want a client-side facility such as psql's \\copy.") : 0));
695 : }
696 :
697 38 : if (fstat(fileno(cstate->copy_file), &st))
698 0 : ereport(ERROR,
699 : (errcode_for_file_access(),
700 : errmsg("could not stat file \"%s\": %m",
701 : cstate->filename)));
702 :
703 38 : if (S_ISDIR(st.st_mode))
704 0 : ereport(ERROR,
705 : (errcode(ERRCODE_WRONG_OBJECT_TYPE),
706 : errmsg("\"%s\" is a directory", cstate->filename)));
707 : }
708 : }
709 :
710 : /* initialize progress */
711 7922 : pgstat_progress_start_command(PROGRESS_COMMAND_COPY,
712 7922 : cstate->rel ? RelationGetRelid(cstate->rel) : InvalidOid);
713 7922 : pgstat_progress_update_multi_param(2, progress_cols, progress_vals);
714 :
715 7922 : cstate->bytes_processed = 0;
716 :
717 7922 : MemoryContextSwitchTo(oldcontext);
718 :
719 7922 : return cstate;
720 : }
721 :
722 : /*
723 : * Clean up storage and release resources for COPY TO.
724 : */
725 : void
726 7920 : EndCopyTo(CopyToState cstate)
727 : {
728 7920 : if (cstate->queryDesc != NULL)
729 : {
730 : /* Close down the query and free resources. */
731 344 : ExecutorFinish(cstate->queryDesc);
732 344 : ExecutorEnd(cstate->queryDesc);
733 344 : FreeQueryDesc(cstate->queryDesc);
734 344 : PopActiveSnapshot();
735 : }
736 :
737 : /* Clean up storage */
738 7920 : EndCopy(cstate);
739 7920 : }
740 :
741 : /*
742 : * Copy from relation or query TO file.
743 : *
744 : * Returns the number of rows processed.
745 : */
746 : uint64
747 7922 : DoCopyTo(CopyToState cstate)
748 : {
749 7922 : bool pipe = (cstate->filename == NULL && cstate->data_dest_cb == NULL);
750 7922 : bool fe_copy = (pipe && whereToSendOutput == DestRemote);
751 : TupleDesc tupDesc;
752 : int num_phys_attrs;
753 : ListCell *cur;
754 : uint64 processed;
755 :
756 7922 : if (fe_copy)
757 7882 : SendCopyBegin(cstate);
758 :
759 7922 : if (cstate->rel)
760 7578 : tupDesc = RelationGetDescr(cstate->rel);
761 : else
762 344 : tupDesc = cstate->queryDesc->tupDesc;
763 7922 : num_phys_attrs = tupDesc->natts;
764 7922 : cstate->opts.null_print_client = cstate->opts.null_print; /* default */
765 :
766 : /* We use fe_msgbuf as a per-row buffer regardless of copy_dest */
767 7922 : cstate->fe_msgbuf = makeStringInfo();
768 :
769 : /* Get info about the columns we need to process. */
770 7922 : cstate->out_functions = (FmgrInfo *) palloc(num_phys_attrs * sizeof(FmgrInfo));
771 37474 : foreach(cur, cstate->attnumlist)
772 : {
773 29554 : int attnum = lfirst_int(cur);
774 : Oid out_func_oid;
775 : bool isvarlena;
776 29554 : Form_pg_attribute attr = TupleDescAttr(tupDesc, attnum - 1);
777 :
778 29554 : if (cstate->opts.binary)
779 62 : getTypeBinaryOutputInfo(attr->atttypid,
780 : &out_func_oid,
781 : &isvarlena);
782 : else
783 29492 : getTypeOutputInfo(attr->atttypid,
784 : &out_func_oid,
785 : &isvarlena);
786 29552 : fmgr_info(out_func_oid, &cstate->out_functions[attnum - 1]);
787 : }
788 :
789 : /*
790 : * Create a temporary memory context that we can reset once per row to
791 : * recover palloc'd memory. This avoids any problems with leaks inside
792 : * datatype output routines, and should be faster than retail pfree's
793 : * anyway. (We don't need a whole econtext as CopyFrom does.)
794 : */
795 7920 : cstate->rowcontext = AllocSetContextCreate(CurrentMemoryContext,
796 : "COPY TO",
797 : ALLOCSET_DEFAULT_SIZES);
798 :
799 7920 : if (cstate->opts.binary)
800 : {
801 : /* Generate header for a binary copy */
802 : int32 tmp;
803 :
804 : /* Signature */
805 14 : CopySendData(cstate, BinarySignature, 11);
806 : /* Flags field */
807 14 : tmp = 0;
808 14 : CopySendInt32(cstate, tmp);
809 : /* No header extension */
810 14 : tmp = 0;
811 14 : CopySendInt32(cstate, tmp);
812 : }
813 : else
814 : {
815 : /*
816 : * For non-binary copy, we need to convert null_print to file
817 : * encoding, because it will be sent directly with CopySendString.
818 : */
819 7906 : if (cstate->need_transcoding)
820 2 : cstate->opts.null_print_client = pg_server_to_any(cstate->opts.null_print,
821 : cstate->opts.null_print_len,
822 : cstate->file_encoding);
823 :
824 : /* if a header has been requested send the line */
825 7906 : if (cstate->opts.header_line)
826 : {
827 18 : bool hdr_delim = false;
828 :
829 54 : foreach(cur, cstate->attnumlist)
830 : {
831 36 : int attnum = lfirst_int(cur);
832 : char *colname;
833 :
834 36 : if (hdr_delim)
835 18 : CopySendChar(cstate, cstate->opts.delim[0]);
836 36 : hdr_delim = true;
837 :
838 36 : colname = NameStr(TupleDescAttr(tupDesc, attnum - 1)->attname);
839 :
840 36 : if (cstate->opts.csv_mode)
841 24 : CopyAttributeOutCSV(cstate, colname, false);
842 : else
843 12 : CopyAttributeOutText(cstate, colname);
844 : }
845 :
846 18 : CopySendEndOfRow(cstate);
847 : }
848 : }
849 :
850 7920 : if (cstate->rel)
851 : {
852 : TupleTableSlot *slot;
853 : TableScanDesc scandesc;
854 :
855 7576 : scandesc = table_beginscan(cstate->rel, GetActiveSnapshot(), 0, NULL);
856 7576 : slot = table_slot_create(cstate->rel, NULL);
857 :
858 7576 : processed = 0;
859 3636862 : while (table_scan_getnextslot(scandesc, ForwardScanDirection, slot))
860 : {
861 3629286 : CHECK_FOR_INTERRUPTS();
862 :
863 : /* Deconstruct the tuple ... */
864 3629286 : slot_getallattrs(slot);
865 :
866 : /* Format and send the data */
867 3629286 : CopyOneRowTo(cstate, slot);
868 :
869 : /*
870 : * Increment the number of processed tuples, and report the
871 : * progress.
872 : */
873 3629286 : pgstat_progress_update_param(PROGRESS_COPY_TUPLES_PROCESSED,
874 : ++processed);
875 : }
876 :
877 7576 : ExecDropSingleTupleTableSlot(slot);
878 7576 : table_endscan(scandesc);
879 : }
880 : else
881 : {
882 : /* run the plan --- the dest receiver will send tuples */
883 344 : ExecutorRun(cstate->queryDesc, ForwardScanDirection, 0, true);
884 344 : processed = ((DR_copy *) cstate->queryDesc->dest)->processed;
885 : }
886 :
887 7920 : if (cstate->opts.binary)
888 : {
889 : /* Generate trailer for a binary copy */
890 14 : CopySendInt16(cstate, -1);
891 : /* Need to flush out the trailer */
892 14 : CopySendEndOfRow(cstate);
893 : }
894 :
895 7920 : MemoryContextDelete(cstate->rowcontext);
896 :
897 7920 : if (fe_copy)
898 7880 : SendCopyEnd(cstate);
899 :
900 7920 : return processed;
901 : }
902 :
903 : /*
904 : * Emit one row during DoCopyTo().
905 : */
906 : static void
907 3636258 : CopyOneRowTo(CopyToState cstate, TupleTableSlot *slot)
908 : {
909 3636258 : FmgrInfo *out_functions = cstate->out_functions;
910 : MemoryContext oldcontext;
911 :
912 3636258 : MemoryContextReset(cstate->rowcontext);
913 3636258 : oldcontext = MemoryContextSwitchTo(cstate->rowcontext);
914 :
915 3636258 : if (cstate->opts.binary)
916 : {
917 : /* Binary per-tuple header */
918 32 : CopySendInt16(cstate, list_length(cstate->attnumlist));
919 : }
920 :
921 : /* Make sure the tuple is fully deconstructed */
922 3636258 : slot_getallattrs(slot);
923 :
924 3636258 : if (!cstate->opts.binary)
925 : {
926 3636226 : bool need_delim = false;
927 :
928 21231038 : foreach_int(attnum, cstate->attnumlist)
929 : {
930 13958586 : Datum value = slot->tts_values[attnum - 1];
931 13958586 : bool isnull = slot->tts_isnull[attnum - 1];
932 : char *string;
933 :
934 13958586 : if (need_delim)
935 10322490 : CopySendChar(cstate, cstate->opts.delim[0]);
936 13958586 : need_delim = true;
937 :
938 13958586 : if (isnull)
939 1155506 : CopySendString(cstate, cstate->opts.null_print_client);
940 : else
941 : {
942 12803080 : string = OutputFunctionCall(&out_functions[attnum - 1],
943 : value);
944 12803080 : if (cstate->opts.csv_mode)
945 570 : CopyAttributeOutCSV(cstate, string,
946 570 : cstate->opts.force_quote_flags[attnum - 1]);
947 : else
948 12802510 : CopyAttributeOutText(cstate, string);
949 : }
950 : }
951 : }
952 : else
953 : {
954 224 : foreach_int(attnum, cstate->attnumlist)
955 : {
956 160 : Datum value = slot->tts_values[attnum - 1];
957 160 : bool isnull = slot->tts_isnull[attnum - 1];
958 : bytea *outputbytes;
959 :
960 160 : if (isnull)
961 30 : CopySendInt32(cstate, -1);
962 : else
963 : {
964 130 : outputbytes = SendFunctionCall(&out_functions[attnum - 1],
965 : value);
966 130 : CopySendInt32(cstate, VARSIZE(outputbytes) - VARHDRSZ);
967 130 : CopySendData(cstate, VARDATA(outputbytes),
968 130 : VARSIZE(outputbytes) - VARHDRSZ);
969 : }
970 : }
971 : }
972 :
973 3636258 : CopySendEndOfRow(cstate);
974 :
975 3636258 : MemoryContextSwitchTo(oldcontext);
976 3636258 : }
977 :
978 : /*
979 : * Send text representation of one attribute, with conversion and escaping
980 : */
981 : #define DUMPSOFAR() \
982 : do { \
983 : if (ptr > start) \
984 : CopySendData(cstate, start, ptr - start); \
985 : } while (0)
986 :
987 : static void
988 12802522 : CopyAttributeOutText(CopyToState cstate, const char *string)
989 : {
990 : const char *ptr;
991 : const char *start;
992 : char c;
993 12802522 : char delimc = cstate->opts.delim[0];
994 :
995 12802522 : if (cstate->need_transcoding)
996 0 : ptr = pg_server_to_any(string, strlen(string), cstate->file_encoding);
997 : else
998 12802522 : ptr = string;
999 :
1000 : /*
1001 : * We have to grovel through the string searching for control characters
1002 : * and instances of the delimiter character. In most cases, though, these
1003 : * are infrequent. To avoid overhead from calling CopySendData once per
1004 : * character, we dump out all characters between escaped characters in a
1005 : * single call. The loop invariant is that the data from "start" to "ptr"
1006 : * can be sent literally, but hasn't yet been.
1007 : *
1008 : * We can skip pg_encoding_mblen() overhead when encoding is safe, because
1009 : * in valid backend encodings, extra bytes of a multibyte character never
1010 : * look like ASCII. This loop is sufficiently performance-critical that
1011 : * it's worth making two copies of it to get the IS_HIGHBIT_SET() test out
1012 : * of the normal safe-encoding path.
1013 : */
1014 12802522 : if (cstate->encoding_embeds_ascii)
1015 : {
1016 0 : start = ptr;
1017 0 : while ((c = *ptr) != '\0')
1018 : {
1019 0 : if ((unsigned char) c < (unsigned char) 0x20)
1020 : {
1021 : /*
1022 : * \r and \n must be escaped, the others are traditional. We
1023 : * prefer to dump these using the C-like notation, rather than
1024 : * a backslash and the literal character, because it makes the
1025 : * dump file a bit more proof against Microsoftish data
1026 : * mangling.
1027 : */
1028 0 : switch (c)
1029 : {
1030 0 : case '\b':
1031 0 : c = 'b';
1032 0 : break;
1033 0 : case '\f':
1034 0 : c = 'f';
1035 0 : break;
1036 0 : case '\n':
1037 0 : c = 'n';
1038 0 : break;
1039 0 : case '\r':
1040 0 : c = 'r';
1041 0 : break;
1042 0 : case '\t':
1043 0 : c = 't';
1044 0 : break;
1045 0 : case '\v':
1046 0 : c = 'v';
1047 0 : break;
1048 0 : default:
1049 : /* If it's the delimiter, must backslash it */
1050 0 : if (c == delimc)
1051 0 : break;
1052 : /* All ASCII control chars are length 1 */
1053 0 : ptr++;
1054 0 : continue; /* fall to end of loop */
1055 : }
1056 : /* if we get here, we need to convert the control char */
1057 0 : DUMPSOFAR();
1058 0 : CopySendChar(cstate, '\\');
1059 0 : CopySendChar(cstate, c);
1060 0 : start = ++ptr; /* do not include char in next run */
1061 : }
1062 0 : else if (c == '\\' || c == delimc)
1063 : {
1064 0 : DUMPSOFAR();
1065 0 : CopySendChar(cstate, '\\');
1066 0 : start = ptr++; /* we include char in next run */
1067 : }
1068 0 : else if (IS_HIGHBIT_SET(c))
1069 0 : ptr += pg_encoding_mblen(cstate->file_encoding, ptr);
1070 : else
1071 0 : ptr++;
1072 : }
1073 : }
1074 : else
1075 : {
1076 12802522 : start = ptr;
1077 133104276 : while ((c = *ptr) != '\0')
1078 : {
1079 120301754 : if ((unsigned char) c < (unsigned char) 0x20)
1080 : {
1081 : /*
1082 : * \r and \n must be escaped, the others are traditional. We
1083 : * prefer to dump these using the C-like notation, rather than
1084 : * a backslash and the literal character, because it makes the
1085 : * dump file a bit more proof against Microsoftish data
1086 : * mangling.
1087 : */
1088 13642 : switch (c)
1089 : {
1090 0 : case '\b':
1091 0 : c = 'b';
1092 0 : break;
1093 0 : case '\f':
1094 0 : c = 'f';
1095 0 : break;
1096 11520 : case '\n':
1097 11520 : c = 'n';
1098 11520 : break;
1099 0 : case '\r':
1100 0 : c = 'r';
1101 0 : break;
1102 2122 : case '\t':
1103 2122 : c = 't';
1104 2122 : break;
1105 0 : case '\v':
1106 0 : c = 'v';
1107 0 : break;
1108 0 : default:
1109 : /* If it's the delimiter, must backslash it */
1110 0 : if (c == delimc)
1111 0 : break;
1112 : /* All ASCII control chars are length 1 */
1113 0 : ptr++;
1114 0 : continue; /* fall to end of loop */
1115 : }
1116 : /* if we get here, we need to convert the control char */
1117 13642 : DUMPSOFAR();
1118 13642 : CopySendChar(cstate, '\\');
1119 13642 : CopySendChar(cstate, c);
1120 13642 : start = ++ptr; /* do not include char in next run */
1121 : }
1122 120288112 : else if (c == '\\' || c == delimc)
1123 : {
1124 4316 : DUMPSOFAR();
1125 4316 : CopySendChar(cstate, '\\');
1126 4316 : start = ptr++; /* we include char in next run */
1127 : }
1128 : else
1129 120283796 : ptr++;
1130 : }
1131 : }
1132 :
1133 12802522 : DUMPSOFAR();
1134 12802522 : }
1135 :
1136 : /*
1137 : * Send text representation of one attribute, with conversion and
1138 : * CSV-style escaping
1139 : */
1140 : static void
1141 594 : CopyAttributeOutCSV(CopyToState cstate, const char *string,
1142 : bool use_quote)
1143 : {
1144 : const char *ptr;
1145 : const char *start;
1146 : char c;
1147 594 : char delimc = cstate->opts.delim[0];
1148 594 : char quotec = cstate->opts.quote[0];
1149 594 : char escapec = cstate->opts.escape[0];
1150 594 : bool single_attr = (list_length(cstate->attnumlist) == 1);
1151 :
1152 : /* force quoting if it matches null_print (before conversion!) */
1153 594 : if (!use_quote && strcmp(string, cstate->opts.null_print) == 0)
1154 54 : use_quote = true;
1155 :
1156 594 : if (cstate->need_transcoding)
1157 0 : ptr = pg_server_to_any(string, strlen(string), cstate->file_encoding);
1158 : else
1159 594 : ptr = string;
1160 :
1161 : /*
1162 : * Make a preliminary pass to discover if it needs quoting
1163 : */
1164 594 : if (!use_quote)
1165 : {
1166 : /*
1167 : * Quote '\.' if it appears alone on a line, so that it will not be
1168 : * interpreted as an end-of-data marker. (PG 18 and up will not
1169 : * interpret '\.' in CSV that way, except in embedded-in-SQL data; but
1170 : * we want the data to be loadable by older versions too. Also, this
1171 : * avoids breaking clients that are still using PQgetline().)
1172 : */
1173 408 : if (single_attr && strcmp(ptr, "\\.") == 0)
1174 6 : use_quote = true;
1175 : else
1176 : {
1177 402 : const char *tptr = ptr;
1178 :
1179 2112 : while ((c = *tptr) != '\0')
1180 : {
1181 1842 : if (c == delimc || c == quotec || c == '\n' || c == '\r')
1182 : {
1183 132 : use_quote = true;
1184 132 : break;
1185 : }
1186 1710 : if (IS_HIGHBIT_SET(c) && cstate->encoding_embeds_ascii)
1187 0 : tptr += pg_encoding_mblen(cstate->file_encoding, tptr);
1188 : else
1189 1710 : tptr++;
1190 : }
1191 : }
1192 : }
1193 :
1194 594 : if (use_quote)
1195 : {
1196 324 : CopySendChar(cstate, quotec);
1197 :
1198 : /*
1199 : * We adopt the same optimization strategy as in CopyAttributeOutText
1200 : */
1201 324 : start = ptr;
1202 2538 : while ((c = *ptr) != '\0')
1203 : {
1204 2214 : if (c == quotec || c == escapec)
1205 : {
1206 156 : DUMPSOFAR();
1207 156 : CopySendChar(cstate, escapec);
1208 156 : start = ptr; /* we include char in next run */
1209 : }
1210 2214 : if (IS_HIGHBIT_SET(c) && cstate->encoding_embeds_ascii)
1211 0 : ptr += pg_encoding_mblen(cstate->file_encoding, ptr);
1212 : else
1213 2214 : ptr++;
1214 : }
1215 324 : DUMPSOFAR();
1216 :
1217 324 : CopySendChar(cstate, quotec);
1218 : }
1219 : else
1220 : {
1221 : /* If it doesn't need quoting, we can just dump it as-is */
1222 270 : CopySendString(cstate, ptr);
1223 : }
1224 594 : }
1225 :
1226 : /*
1227 : * copy_dest_startup --- executor startup
1228 : */
1229 : static void
1230 344 : copy_dest_startup(DestReceiver *self, int operation, TupleDesc typeinfo)
1231 : {
1232 : /* no-op */
1233 344 : }
1234 :
1235 : /*
1236 : * copy_dest_receive --- receive one tuple
1237 : */
1238 : static bool
1239 6972 : copy_dest_receive(TupleTableSlot *slot, DestReceiver *self)
1240 : {
1241 6972 : DR_copy *myState = (DR_copy *) self;
1242 6972 : CopyToState cstate = myState->cstate;
1243 :
1244 : /* Send the data */
1245 6972 : CopyOneRowTo(cstate, slot);
1246 :
1247 : /* Increment the number of processed tuples, and report the progress */
1248 6972 : pgstat_progress_update_param(PROGRESS_COPY_TUPLES_PROCESSED,
1249 6972 : ++myState->processed);
1250 :
1251 6972 : return true;
1252 : }
1253 :
1254 : /*
1255 : * copy_dest_shutdown --- executor end
1256 : */
1257 : static void
1258 344 : copy_dest_shutdown(DestReceiver *self)
1259 : {
1260 : /* no-op */
1261 344 : }
1262 :
1263 : /*
1264 : * copy_dest_destroy --- release DestReceiver object
1265 : */
1266 : static void
1267 0 : copy_dest_destroy(DestReceiver *self)
1268 : {
1269 0 : pfree(self);
1270 0 : }
1271 :
1272 : /*
1273 : * CreateCopyDestReceiver -- create a suitable DestReceiver object
1274 : */
1275 : DestReceiver *
1276 350 : CreateCopyDestReceiver(void)
1277 : {
1278 350 : DR_copy *self = (DR_copy *) palloc(sizeof(DR_copy));
1279 :
1280 350 : self->pub.receiveSlot = copy_dest_receive;
1281 350 : self->pub.rStartup = copy_dest_startup;
1282 350 : self->pub.rShutdown = copy_dest_shutdown;
1283 350 : self->pub.rDestroy = copy_dest_destroy;
1284 350 : self->pub.mydest = DestCopyOut;
1285 :
1286 350 : self->cstate = NULL; /* will be set later */
1287 350 : self->processed = 0;
1288 :
1289 350 : return (DestReceiver *) self;
1290 : }
|