pg 1.2.3-x86-mingw32 → 1.3.0.rc4-x86-mingw32

Sign up to get free protection for your applications and to get access to all the features.
Files changed (112) hide show
  1. checksums.yaml +4 -4
  2. checksums.yaml.gz.sig +0 -0
  3. data/.appveyor.yml +36 -0
  4. data/.gems +6 -0
  5. data/.github/workflows/binary-gems.yml +86 -0
  6. data/.github/workflows/source-gem.yml +130 -0
  7. data/.gitignore +13 -0
  8. data/.hgsigs +34 -0
  9. data/.hgtags +41 -0
  10. data/.irbrc +23 -0
  11. data/.pryrc +23 -0
  12. data/.tm_properties +21 -0
  13. data/.travis.yml +49 -0
  14. data/Gemfile +14 -0
  15. data/History.rdoc +77 -7
  16. data/Manifest.txt +0 -1
  17. data/README.rdoc +7 -6
  18. data/Rakefile +27 -138
  19. data/Rakefile.cross +6 -5
  20. data/certs/ged.pem +24 -0
  21. data/ext/errorcodes.def +8 -0
  22. data/ext/errorcodes.txt +3 -1
  23. data/ext/extconf.rb +91 -19
  24. data/ext/gvl_wrappers.c +4 -0
  25. data/ext/gvl_wrappers.h +23 -0
  26. data/ext/pg.c +59 -4
  27. data/ext/pg.h +18 -1
  28. data/ext/pg_coder.c +82 -28
  29. data/ext/pg_connection.c +676 -492
  30. data/ext/pg_copy_coder.c +45 -16
  31. data/ext/pg_record_coder.c +39 -11
  32. data/ext/pg_result.c +61 -31
  33. data/ext/pg_text_decoder.c +1 -1
  34. data/ext/pg_text_encoder.c +6 -6
  35. data/ext/pg_tuple.c +47 -21
  36. data/ext/pg_type_map.c +41 -8
  37. data/ext/pg_type_map_all_strings.c +14 -1
  38. data/ext/pg_type_map_by_class.c +49 -24
  39. data/ext/pg_type_map_by_column.c +64 -28
  40. data/ext/pg_type_map_by_mri_type.c +47 -18
  41. data/ext/pg_type_map_by_oid.c +52 -23
  42. data/ext/pg_type_map_in_ruby.c +50 -19
  43. data/ext/pg_util.c +2 -2
  44. data/lib/2.5/pg_ext.so +0 -0
  45. data/lib/2.6/pg_ext.so +0 -0
  46. data/lib/2.7/pg_ext.so +0 -0
  47. data/lib/3.0/pg_ext.so +0 -0
  48. data/lib/3.1/pg_ext.so +0 -0
  49. data/lib/pg/basic_type_map_based_on_result.rb +47 -0
  50. data/lib/pg/basic_type_map_for_queries.rb +193 -0
  51. data/lib/pg/basic_type_map_for_results.rb +81 -0
  52. data/lib/pg/basic_type_registry.rb +296 -0
  53. data/lib/pg/coder.rb +1 -1
  54. data/lib/pg/connection.rb +587 -58
  55. data/lib/pg/version.rb +4 -0
  56. data/lib/pg.rb +40 -27
  57. data/lib/x86-mingw32/libpq.dll +0 -0
  58. data/misc/openssl-pg-segfault.rb +31 -0
  59. data/misc/postgres/History.txt +9 -0
  60. data/misc/postgres/Manifest.txt +5 -0
  61. data/misc/postgres/README.txt +21 -0
  62. data/misc/postgres/Rakefile +21 -0
  63. data/misc/postgres/lib/postgres.rb +16 -0
  64. data/misc/ruby-pg/History.txt +9 -0
  65. data/misc/ruby-pg/Manifest.txt +5 -0
  66. data/misc/ruby-pg/README.txt +21 -0
  67. data/misc/ruby-pg/Rakefile +21 -0
  68. data/misc/ruby-pg/lib/ruby/pg.rb +16 -0
  69. data/pg.gemspec +32 -0
  70. data/sample/array_insert.rb +20 -0
  71. data/sample/async_api.rb +106 -0
  72. data/sample/async_copyto.rb +39 -0
  73. data/sample/async_mixed.rb +56 -0
  74. data/sample/check_conn.rb +21 -0
  75. data/sample/copydata.rb +71 -0
  76. data/sample/copyfrom.rb +81 -0
  77. data/sample/copyto.rb +19 -0
  78. data/sample/cursor.rb +21 -0
  79. data/sample/disk_usage_report.rb +177 -0
  80. data/sample/issue-119.rb +94 -0
  81. data/sample/losample.rb +69 -0
  82. data/sample/minimal-testcase.rb +17 -0
  83. data/sample/notify_wait.rb +72 -0
  84. data/sample/pg_statistics.rb +285 -0
  85. data/sample/replication_monitor.rb +222 -0
  86. data/sample/test_binary_values.rb +33 -0
  87. data/sample/wal_shipper.rb +434 -0
  88. data/sample/warehouse_partitions.rb +311 -0
  89. data.tar.gz.sig +0 -0
  90. metadata +93 -233
  91. metadata.gz.sig +0 -0
  92. data/ChangeLog +0 -0
  93. data/lib/2.2/pg_ext.so +0 -0
  94. data/lib/2.3/pg_ext.so +0 -0
  95. data/lib/2.4/pg_ext.so +0 -0
  96. data/lib/pg/basic_type_mapping.rb +0 -522
  97. data/spec/data/expected_trace.out +0 -26
  98. data/spec/data/random_binary_data +0 -0
  99. data/spec/helpers.rb +0 -380
  100. data/spec/pg/basic_type_mapping_spec.rb +0 -630
  101. data/spec/pg/connection_spec.rb +0 -1949
  102. data/spec/pg/connection_sync_spec.rb +0 -41
  103. data/spec/pg/result_spec.rb +0 -681
  104. data/spec/pg/tuple_spec.rb +0 -333
  105. data/spec/pg/type_map_by_class_spec.rb +0 -138
  106. data/spec/pg/type_map_by_column_spec.rb +0 -226
  107. data/spec/pg/type_map_by_mri_type_spec.rb +0 -136
  108. data/spec/pg/type_map_by_oid_spec.rb +0 -149
  109. data/spec/pg/type_map_in_ruby_spec.rb +0 -164
  110. data/spec/pg/type_map_spec.rb +0 -22
  111. data/spec/pg/type_spec.rb +0 -1123
  112. data/spec/pg_spec.rb +0 -50
data/ext/pg_connection.c CHANGED
@@ -12,6 +12,7 @@
12
12
 
13
13
  VALUE rb_cPGconn;
14
14
  static ID s_id_encode;
15
+ static ID s_id_autoclose_set;
15
16
  static VALUE sym_type, sym_format, sym_value;
16
17
  static VALUE sym_symbol, sym_string, sym_static_symbol;
17
18
 
@@ -20,7 +21,9 @@ static PQnoticeProcessor default_notice_processor = NULL;
20
21
 
21
22
  static VALUE pgconn_finish( VALUE );
22
23
  static VALUE pgconn_set_default_encoding( VALUE self );
24
+ static VALUE pgconn_wait_for_flush( VALUE self );
23
25
  static void pgconn_set_internal_encoding_index( VALUE );
26
+ static const rb_data_type_t pg_connection_type;
24
27
 
25
28
  /*
26
29
  * Global functions
@@ -33,7 +36,7 @@ t_pg_connection *
33
36
  pg_get_connection( VALUE self )
34
37
  {
35
38
  t_pg_connection *this;
36
- Data_Get_Struct( self, t_pg_connection, this);
39
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
37
40
 
38
41
  return this;
39
42
  }
@@ -46,7 +49,7 @@ static t_pg_connection *
46
49
  pg_get_connection_safe( VALUE self )
47
50
  {
48
51
  t_pg_connection *this;
49
- Data_Get_Struct( self, t_pg_connection, this);
52
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
50
53
 
51
54
  if ( !this->pgconn )
52
55
  rb_raise( rb_eConnectionBad, "connection is closed" );
@@ -65,7 +68,7 @@ PGconn *
65
68
  pg_get_pgconn( VALUE self )
66
69
  {
67
70
  t_pg_connection *this;
68
- Data_Get_Struct( self, t_pg_connection, this);
71
+ TypedData_Get_Struct( self, t_pg_connection, &pg_connection_type, this);
69
72
 
70
73
  if ( !this->pgconn )
71
74
  rb_raise( rb_eConnectionBad, "connection is closed" );
@@ -145,16 +148,31 @@ static const char *pg_cstr_enc(VALUE str, int enc_idx){
145
148
  * GC Mark function
146
149
  */
147
150
  static void
148
- pgconn_gc_mark( t_pg_connection *this )
151
+ pgconn_gc_mark( void *_this )
149
152
  {
150
- rb_gc_mark( this->socket_io );
151
- rb_gc_mark( this->notice_receiver );
152
- rb_gc_mark( this->notice_processor );
153
- rb_gc_mark( this->type_map_for_queries );
154
- rb_gc_mark( this->type_map_for_results );
155
- rb_gc_mark( this->trace_stream );
156
- rb_gc_mark( this->encoder_for_put_copy_data );
157
- rb_gc_mark( this->decoder_for_get_copy_data );
153
+ t_pg_connection *this = (t_pg_connection *)_this;
154
+ rb_gc_mark_movable( this->socket_io );
155
+ rb_gc_mark_movable( this->notice_receiver );
156
+ rb_gc_mark_movable( this->notice_processor );
157
+ rb_gc_mark_movable( this->type_map_for_queries );
158
+ rb_gc_mark_movable( this->type_map_for_results );
159
+ rb_gc_mark_movable( this->trace_stream );
160
+ rb_gc_mark_movable( this->encoder_for_put_copy_data );
161
+ rb_gc_mark_movable( this->decoder_for_get_copy_data );
162
+ }
163
+
164
+ static void
165
+ pgconn_gc_compact( void *_this )
166
+ {
167
+ t_pg_connection *this = (t_pg_connection *)_this;
168
+ pg_gc_location( this->socket_io );
169
+ pg_gc_location( this->notice_receiver );
170
+ pg_gc_location( this->notice_processor );
171
+ pg_gc_location( this->type_map_for_queries );
172
+ pg_gc_location( this->type_map_for_results );
173
+ pg_gc_location( this->trace_stream );
174
+ pg_gc_location( this->encoder_for_put_copy_data );
175
+ pg_gc_location( this->decoder_for_get_copy_data );
158
176
  }
159
177
 
160
178
 
@@ -162,11 +180,15 @@ pgconn_gc_mark( t_pg_connection *this )
162
180
  * GC Free function
163
181
  */
164
182
  static void
165
- pgconn_gc_free( t_pg_connection *this )
183
+ pgconn_gc_free( void *_this )
166
184
  {
185
+ t_pg_connection *this = (t_pg_connection *)_this;
167
186
  #if defined(_WIN32)
168
- if ( RTEST(this->socket_io) )
169
- rb_w32_unwrap_io_handle( this->ruby_sd );
187
+ if ( RTEST(this->socket_io) ) {
188
+ if( rb_w32_unwrap_io_handle(this->ruby_sd) ){
189
+ rb_warn("pg: Could not unwrap win32 socket handle by garbage collector");
190
+ }
191
+ }
170
192
  #endif
171
193
  if (this->pgconn != NULL)
172
194
  PQfinish( this->pgconn );
@@ -174,6 +196,29 @@ pgconn_gc_free( t_pg_connection *this )
174
196
  xfree(this);
175
197
  }
176
198
 
199
+ /*
200
+ * Object Size function
201
+ */
202
+ static size_t
203
+ pgconn_memsize( const void *_this )
204
+ {
205
+ const t_pg_connection *this = (const t_pg_connection *)_this;
206
+ return sizeof(*this);
207
+ }
208
+
209
+ static const rb_data_type_t pg_connection_type = {
210
+ "PG::Connection",
211
+ {
212
+ pgconn_gc_mark,
213
+ pgconn_gc_free,
214
+ pgconn_memsize,
215
+ pg_compact_callback(pgconn_gc_compact),
216
+ },
217
+ 0,
218
+ 0,
219
+ 0,
220
+ };
221
+
177
222
 
178
223
  /**************************************************************************
179
224
  * Class Methods
@@ -189,7 +234,7 @@ static VALUE
189
234
  pgconn_s_allocate( VALUE klass )
190
235
  {
191
236
  t_pg_connection *this;
192
- VALUE self = Data_Make_Struct( klass, t_pg_connection, pgconn_gc_mark, pgconn_gc_free, this );
237
+ VALUE self = TypedData_Make_Struct( klass, t_pg_connection, &pg_connection_type, this );
193
238
 
194
239
  this->pgconn = NULL;
195
240
  this->socket_io = Qnil;
@@ -204,65 +249,13 @@ pgconn_s_allocate( VALUE klass )
204
249
  return self;
205
250
  }
206
251
 
207
-
208
- /*
209
- * Document-method: new
210
- *
211
- * call-seq:
212
- * PG::Connection.new -> conn
213
- * PG::Connection.new(connection_hash) -> conn
214
- * PG::Connection.new(connection_string) -> conn
215
- * PG::Connection.new(host, port, options, tty, dbname, user, password) -> conn
216
- *
217
- * Create a connection to the specified server.
218
- *
219
- * +connection_hash+ must be a ruby Hash with connection parameters.
220
- * See the {list of valid parameters}[https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-PARAMKEYWORDS] in the PostgreSQL documentation.
221
- *
222
- * There are two accepted formats for +connection_string+: plain <code>keyword = value</code> strings and URIs.
223
- * See the documentation of {connection strings}[https://www.postgresql.org/docs/current/libpq-connect.html#LIBPQ-CONNSTRING].
224
- *
225
- * The positional parameter form has the same functionality except that the missing parameters will always take on default values. The parameters are:
226
- * [+host+]
227
- * server hostname
228
- * [+port+]
229
- * server port number
230
- * [+options+]
231
- * backend options
232
- * [+tty+]
233
- * (ignored in newer versions of PostgreSQL)
234
- * [+dbname+]
235
- * connecting database name
236
- * [+user+]
237
- * login user name
238
- * [+password+]
239
- * login password
240
- *
241
- * Examples:
242
- *
243
- * # Connect using all defaults
244
- * PG::Connection.new
245
- *
246
- * # As a Hash
247
- * PG::Connection.new( :dbname => 'test', :port => 5432 )
248
- *
249
- * # As a String
250
- * PG::Connection.new( "dbname=test port=5432" )
251
- *
252
- * # As an Array
253
- * PG::Connection.new( nil, 5432, nil, nil, 'test', nil, nil )
254
- *
255
- * If the Ruby default internal encoding is set (i.e., <code>Encoding.default_internal != nil</code>), the
256
- * connection will have its +client_encoding+ set accordingly.
257
- *
258
- * Raises a PG::Error if the connection fails.
259
- */
260
252
  static VALUE
261
- pgconn_init(int argc, VALUE *argv, VALUE self)
253
+ pgconn_s_sync_connect(int argc, VALUE *argv, VALUE klass)
262
254
  {
263
255
  t_pg_connection *this;
264
256
  VALUE conninfo;
265
257
  VALUE error;
258
+ VALUE self = pgconn_s_allocate( klass );
266
259
 
267
260
  this = pg_get_connection( self );
268
261
  conninfo = rb_funcall2( rb_cPGconn, rb_intern("parse_connect_args"), argc, argv );
@@ -335,34 +328,14 @@ pgconn_s_connect_start( int argc, VALUE *argv, VALUE klass )
335
328
  return rb_conn;
336
329
  }
337
330
 
338
- /*
339
- * call-seq:
340
- * PG::Connection.ping(connection_hash) -> Integer
341
- * PG::Connection.ping(connection_string) -> Integer
342
- * PG::Connection.ping(host, port, options, tty, dbname, login, password) -> Integer
343
- *
344
- * Check server status.
345
- *
346
- * See PG::Connection.new for a description of the parameters.
347
- *
348
- * Returns one of:
349
- * [+PQPING_OK+]
350
- * server is accepting connections
351
- * [+PQPING_REJECT+]
352
- * server is alive but rejecting connections
353
- * [+PQPING_NO_RESPONSE+]
354
- * could not establish connection
355
- * [+PQPING_NO_ATTEMPT+]
356
- * connection not attempted (bad params)
357
- */
358
331
  static VALUE
359
- pgconn_s_ping( int argc, VALUE *argv, VALUE klass )
332
+ pgconn_s_sync_ping( int argc, VALUE *argv, VALUE klass )
360
333
  {
361
334
  PGPing ping;
362
335
  VALUE conninfo;
363
336
 
364
337
  conninfo = rb_funcall2( klass, rb_intern("parse_connect_args"), argc, argv );
365
- ping = PQping( StringValueCStr(conninfo) );
338
+ ping = gvl_PQping( StringValueCStr(conninfo) );
366
339
 
367
340
  return INT2FIX((int)ping);
368
341
  }
@@ -405,30 +378,8 @@ pgconn_s_conndefaults(VALUE self)
405
378
 
406
379
 
407
380
  #ifdef HAVE_PQENCRYPTPASSWORDCONN
408
- /*
409
- * call-seq:
410
- * conn.encrypt_password( password, username, algorithm=nil ) -> String
411
- *
412
- * This function is intended to be used by client applications that wish to send commands like <tt>ALTER USER joe PASSWORD 'pwd'</tt>.
413
- * It is good practice not to send the original cleartext password in such a command, because it might be exposed in command logs, activity displays, and so on.
414
- * Instead, use this function to convert the password to encrypted form before it is sent.
415
- *
416
- * The +password+ and +username+ arguments are the cleartext password, and the SQL name of the user it is for.
417
- * +algorithm+ specifies the encryption algorithm to use to encrypt the password.
418
- * Currently supported algorithms are +md5+ and +scram-sha-256+ (+on+ and +off+ are also accepted as aliases for +md5+, for compatibility with older server versions).
419
- * Note that support for +scram-sha-256+ was introduced in PostgreSQL version 10, and will not work correctly with older server versions.
420
- * If algorithm is omitted or +nil+, this function will query the server for the current value of the +password_encryption+ setting.
421
- * That can block, and will fail if the current transaction is aborted, or if the connection is busy executing another query.
422
- * If you wish to use the default algorithm for the server but want to avoid blocking, query +password_encryption+ yourself before calling #encrypt_password, and pass that value as the algorithm.
423
- *
424
- * Return value is the encrypted password.
425
- * The caller can assume the string doesn't contain any special characters that would require escaping.
426
- *
427
- * Available since PostgreSQL-10.
428
- * See also corresponding {libpq function}[https://www.postgresql.org/docs/current/libpq-misc.html#LIBPQ-PQENCRYPTPASSWORDCONN].
429
- */
430
381
  static VALUE
431
- pgconn_encrypt_password(int argc, VALUE *argv, VALUE self)
382
+ pgconn_sync_encrypt_password(int argc, VALUE *argv, VALUE self)
432
383
  {
433
384
  char *encrypted = NULL;
434
385
  VALUE rval = Qnil;
@@ -523,6 +474,11 @@ pgconn_connect_poll(VALUE self)
523
474
  {
524
475
  PostgresPollingStatusType status;
525
476
  status = gvl_PQconnectPoll(pg_get_pgconn(self));
477
+
478
+ if ( status == PGRES_POLLING_FAILED ) {
479
+ pgconn_close_socket_io(self);
480
+ }
481
+
526
482
  return INT2FIX((int)status);
527
483
  }
528
484
 
@@ -559,15 +515,8 @@ pgconn_finished_p( VALUE self )
559
515
  }
560
516
 
561
517
 
562
- /*
563
- * call-seq:
564
- * conn.reset()
565
- *
566
- * Resets the backend connection. This method closes the
567
- * backend connection and tries to re-connect.
568
- */
569
518
  static VALUE
570
- pgconn_reset( VALUE self )
519
+ pgconn_sync_reset( VALUE self )
571
520
  {
572
521
  pgconn_close_socket_io( self );
573
522
  gvl_PQreset( pg_get_pgconn(self) );
@@ -606,6 +555,11 @@ pgconn_reset_poll(VALUE self)
606
555
  {
607
556
  PostgresPollingStatusType status;
608
557
  status = gvl_PQresetPoll(pg_get_pgconn(self));
558
+
559
+ if ( status == PGRES_POLLING_FAILED ) {
560
+ pgconn_close_socket_io(self);
561
+ }
562
+
609
563
  return INT2FIX((int)status);
610
564
  }
611
565
 
@@ -676,21 +630,19 @@ static VALUE
676
630
  pgconn_port(VALUE self)
677
631
  {
678
632
  char* port = PQport(pg_get_pgconn(self));
679
- return INT2NUM(atol(port));
633
+ return INT2NUM(atoi(port));
680
634
  }
681
635
 
682
636
  /*
683
637
  * call-seq:
684
638
  * conn.tty()
685
639
  *
686
- * Returns the connected pgtty. (Obsolete)
640
+ * Obsolete function.
687
641
  */
688
642
  static VALUE
689
643
  pgconn_tty(VALUE self)
690
644
  {
691
- char *tty = PQtty(pg_get_pgconn(self));
692
- if (!tty) return Qnil;
693
- return rb_str_new2(tty);
645
+ return rb_str_new2("");
694
646
  }
695
647
 
696
648
  /*
@@ -708,7 +660,6 @@ pgconn_options(VALUE self)
708
660
  }
709
661
 
710
662
 
711
- #ifdef HAVE_PQCONNINFO
712
663
  /*
713
664
  * call-seq:
714
665
  * conn.conninfo -> hash
@@ -728,14 +679,17 @@ pgconn_conninfo( VALUE self )
728
679
 
729
680
  return array;
730
681
  }
731
- #endif
732
682
 
733
683
 
734
684
  /*
735
685
  * call-seq:
736
686
  * conn.status()
737
687
  *
738
- * Returns status of connection : CONNECTION_OK or CONNECTION_BAD
688
+ * Returns the status of the connection, which is one:
689
+ * PG::Constants::CONNECTION_OK
690
+ * PG::Constants::CONNECTION_BAD
691
+ *
692
+ * ... and other constants of kind PG::Constants::CONNECTION_*
739
693
  */
740
694
  static VALUE
741
695
  pgconn_status(VALUE self)
@@ -823,7 +777,10 @@ pgconn_server_version(VALUE self)
823
777
  * call-seq:
824
778
  * conn.error_message -> String
825
779
  *
826
- * Returns the error message about connection.
780
+ * Returns the error message most recently generated by an operation on the connection.
781
+ *
782
+ * Nearly all libpq functions will set a message for conn.error_message if they fail.
783
+ * Note that by libpq convention, a nonempty error_message result can consist of multiple lines, and will include a trailing newline.
827
784
  */
828
785
  static VALUE
829
786
  pgconn_error_message(VALUE self)
@@ -878,8 +835,8 @@ pgconn_socket_io(VALUE self)
878
835
  {
879
836
  int sd;
880
837
  int ruby_sd;
881
- ID id_autoclose = rb_intern("autoclose=");
882
838
  t_pg_connection *this = pg_get_connection_safe( self );
839
+ VALUE cSocket;
883
840
  VALUE socket_io = this->socket_io;
884
841
 
885
842
  if ( !RTEST(socket_io) ) {
@@ -888,15 +845,19 @@ pgconn_socket_io(VALUE self)
888
845
 
889
846
  #ifdef _WIN32
890
847
  ruby_sd = rb_w32_wrap_io_handle((HANDLE)(intptr_t)sd, O_RDWR|O_BINARY|O_NOINHERIT);
848
+ if( ruby_sd == -1 ){
849
+ rb_raise(rb_eConnectionBad, "Could not wrap win32 socket handle");
850
+ }
891
851
  this->ruby_sd = ruby_sd;
892
852
  #else
893
853
  ruby_sd = sd;
894
854
  #endif
895
855
 
896
- socket_io = rb_funcall( rb_cIO, rb_intern("for_fd"), 1, INT2NUM(ruby_sd) );
856
+ cSocket = rb_const_get(rb_cObject, rb_intern("BasicSocket"));
857
+ socket_io = rb_funcall( cSocket, rb_intern("for_fd"), 1, INT2NUM(ruby_sd));
897
858
 
898
859
  /* Disable autoclose feature */
899
- rb_funcall( socket_io, id_autoclose, 1, Qfalse );
860
+ rb_funcall( socket_io, s_id_autoclose_set, 1, Qfalse );
900
861
 
901
862
  this->socket_io = socket_io;
902
863
  }
@@ -918,6 +879,51 @@ pgconn_backend_pid(VALUE self)
918
879
  return INT2NUM(PQbackendPID(pg_get_pgconn(self)));
919
880
  }
920
881
 
882
+ typedef struct
883
+ {
884
+ struct sockaddr_storage addr;
885
+ socklen_t salen;
886
+ } SockAddr;
887
+
888
+ /* Copy of struct pg_cancel from libpq-int.h
889
+ *
890
+ * See https://github.com/postgres/postgres/blame/master/src/interfaces/libpq/libpq-int.h#L577-L586
891
+ */
892
+ struct pg_cancel
893
+ {
894
+ SockAddr raddr; /* Remote address */
895
+ int be_pid; /* PID of backend --- needed for cancels */
896
+ int be_key; /* key of backend --- needed for cancels */
897
+ };
898
+
899
+ /*
900
+ * call-seq:
901
+ * conn.backend_key() -> Integer
902
+ *
903
+ * Returns the key of the backend server process for this connection.
904
+ * This key can be used to cancel queries on the server.
905
+ */
906
+ static VALUE
907
+ pgconn_backend_key(VALUE self)
908
+ {
909
+ int be_key;
910
+ struct pg_cancel *cancel;
911
+ PGconn *conn = pg_get_pgconn(self);
912
+
913
+ cancel = (struct pg_cancel*)PQgetCancel(conn);
914
+ if(cancel == NULL)
915
+ rb_raise(rb_ePGerror,"Invalid connection!");
916
+
917
+ if( cancel->be_pid != PQbackendPID(conn) )
918
+ rb_raise(rb_ePGerror,"Unexpected binary struct layout - please file a bug report at ruby-pg!");
919
+
920
+ be_key = cancel->be_key;
921
+
922
+ PQfreeCancel(cancel);
923
+
924
+ return INT2NUM(be_key);
925
+ }
926
+
921
927
  /*
922
928
  * call-seq:
923
929
  * conn.connection_needs_password() -> Boolean
@@ -948,7 +954,7 @@ pgconn_connection_used_password(VALUE self)
948
954
  /* :TODO: get_ssl */
949
955
 
950
956
 
951
- static VALUE pgconn_exec_params( int, VALUE *, VALUE );
957
+ static VALUE pgconn_sync_exec_params( int, VALUE *, VALUE );
952
958
 
953
959
  /*
954
960
  * call-seq:
@@ -962,11 +968,11 @@ static VALUE pgconn_exec_params( int, VALUE *, VALUE );
962
968
  * However #async_exec has two advantages:
963
969
  *
964
970
  * 1. #async_exec can be aborted by signals (like Ctrl-C), while #exec blocks signal processing until the query is answered.
965
- * 2. Ruby VM gets notified about IO blocked operations.
966
- * It can therefore schedule things like garbage collection, while queries are running like in this proposal: https://bugs.ruby-lang.org/issues/14723
971
+ * 2. Ruby VM gets notified about IO blocked operations and can pass them through <tt>Fiber.scheduler</tt>.
972
+ * So only <tt>async_*</tt> methods are compatible to event based schedulers like the async gem.
967
973
  */
968
974
  static VALUE
969
- pgconn_exec(int argc, VALUE *argv, VALUE self)
975
+ pgconn_sync_exec(int argc, VALUE *argv, VALUE self)
970
976
  {
971
977
  t_pg_connection *this = pg_get_connection_safe( self );
972
978
  PGresult *result = NULL;
@@ -987,7 +993,7 @@ pgconn_exec(int argc, VALUE *argv, VALUE self)
987
993
  pg_deprecated(0, ("forwarding exec to exec_params is deprecated"));
988
994
 
989
995
  /* Otherwise, just call #exec_params instead for backward-compatibility */
990
- return pgconn_exec_params( argc, argv, self );
996
+ return pgconn_sync_exec_params( argc, argv, self );
991
997
 
992
998
  }
993
999
 
@@ -1019,7 +1025,7 @@ struct query_params_data {
1019
1025
  * Filled by alloc_query_params()
1020
1026
  */
1021
1027
 
1022
- /* Wraps the pointer of allocated memory, if function parameters dont't
1028
+ /* Wraps the pointer of allocated memory, if function parameters don't
1023
1029
  * fit in the memory_pool below.
1024
1030
  */
1025
1031
  VALUE heap_pool;
@@ -1037,7 +1043,7 @@ struct query_params_data {
1037
1043
  Oid *types;
1038
1044
 
1039
1045
  /* This array takes the string values for the timeframe of the query,
1040
- * if param value convertion is required
1046
+ * if param value conversion is required
1041
1047
  */
1042
1048
  VALUE gc_array;
1043
1049
 
@@ -1051,8 +1057,9 @@ struct query_params_data {
1051
1057
  };
1052
1058
 
1053
1059
  static void
1054
- free_typecast_heap_chain(struct linked_typecast_data *chain_entry)
1060
+ free_typecast_heap_chain(void *_chain_entry)
1055
1061
  {
1062
+ struct linked_typecast_data *chain_entry = (struct linked_typecast_data *)_chain_entry;
1056
1063
  while(chain_entry){
1057
1064
  struct linked_typecast_data *next = chain_entry->next;
1058
1065
  xfree(chain_entry);
@@ -1060,6 +1067,18 @@ free_typecast_heap_chain(struct linked_typecast_data *chain_entry)
1060
1067
  }
1061
1068
  }
1062
1069
 
1070
+ static const rb_data_type_t pg_typecast_buffer_type = {
1071
+ "PG::Connection typecast buffer chain",
1072
+ {
1073
+ (RUBY_DATA_FUNC) NULL,
1074
+ free_typecast_heap_chain,
1075
+ (size_t (*)(const void *))NULL,
1076
+ },
1077
+ 0,
1078
+ 0,
1079
+ RUBY_TYPED_FREE_IMMEDIATELY,
1080
+ };
1081
+
1063
1082
  static char *
1064
1083
  alloc_typecast_buf( VALUE *typecast_heap_chain, int len )
1065
1084
  {
@@ -1070,17 +1089,28 @@ alloc_typecast_buf( VALUE *typecast_heap_chain, int len )
1070
1089
  /* Did we already wrap a memory chain per T_DATA object? */
1071
1090
  if( NIL_P( *typecast_heap_chain ) ){
1072
1091
  /* Leave free'ing of the buffer chain to the GC, when paramsData has left the stack */
1073
- *typecast_heap_chain = Data_Wrap_Struct( rb_cObject, NULL, free_typecast_heap_chain, allocated );
1092
+ *typecast_heap_chain = TypedData_Wrap_Struct( rb_cObject, &pg_typecast_buffer_type, allocated );
1074
1093
  allocated->next = NULL;
1075
1094
  } else {
1076
1095
  /* Append to the chain */
1077
- allocated->next = DATA_PTR( *typecast_heap_chain );
1078
- DATA_PTR( *typecast_heap_chain ) = allocated;
1096
+ allocated->next = RTYPEDDATA_DATA( *typecast_heap_chain );
1097
+ RTYPEDDATA_DATA( *typecast_heap_chain ) = allocated;
1079
1098
  }
1080
1099
 
1081
1100
  return &allocated->data[0];
1082
1101
  }
1083
1102
 
1103
+ static const rb_data_type_t pg_query_heap_pool_type = {
1104
+ "PG::Connection query heap pool",
1105
+ {
1106
+ (RUBY_DATA_FUNC) NULL,
1107
+ RUBY_TYPED_DEFAULT_FREE,
1108
+ (size_t (*)(const void *))NULL,
1109
+ },
1110
+ 0,
1111
+ 0,
1112
+ RUBY_TYPED_FREE_IMMEDIATELY,
1113
+ };
1084
1114
 
1085
1115
  static int
1086
1116
  alloc_query_params(struct query_params_data *paramsData)
@@ -1095,7 +1125,7 @@ alloc_query_params(struct query_params_data *paramsData)
1095
1125
 
1096
1126
  Check_Type(paramsData->params, T_ARRAY);
1097
1127
 
1098
- p_typemap = DATA_PTR( paramsData->typemap );
1128
+ p_typemap = RTYPEDDATA_DATA( paramsData->typemap );
1099
1129
  p_typemap->funcs.fit_to_query( paramsData->typemap, paramsData->params );
1100
1130
 
1101
1131
  paramsData->heap_pool = Qnil;
@@ -1114,7 +1144,7 @@ alloc_query_params(struct query_params_data *paramsData)
1114
1144
  /* Allocate one combined memory pool for all possible function parameters */
1115
1145
  memory_pool = (char*)xmalloc( required_pool_size );
1116
1146
  /* Leave free'ing of the buffer to the GC, when paramsData has left the stack */
1117
- paramsData->heap_pool = Data_Wrap_Struct( rb_cObject, NULL, -1, memory_pool );
1147
+ paramsData->heap_pool = TypedData_Wrap_Struct( rb_cObject, &pg_query_heap_pool_type, memory_pool );
1118
1148
  required_pool_size = 0;
1119
1149
  }else{
1120
1150
  /* Use stack memory for function parameters */
@@ -1227,12 +1257,11 @@ pgconn_query_assign_typemap( VALUE self, struct query_params_data *paramsData )
1227
1257
  /* Use default typemap for queries. It's type is checked when assigned. */
1228
1258
  paramsData->typemap = pg_get_connection(self)->type_map_for_queries;
1229
1259
  }else{
1260
+ t_typemap *tm;
1261
+ UNUSED(tm);
1262
+
1230
1263
  /* Check type of method param */
1231
- if ( !rb_obj_is_kind_of(paramsData->typemap, rb_cTypeMap) ) {
1232
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
1233
- rb_obj_classname( paramsData->typemap ) );
1234
- }
1235
- Check_Type( paramsData->typemap, T_DATA );
1264
+ TypedData_Get_Struct(paramsData->typemap, t_typemap, &pg_typemap_type, tm);
1236
1265
  }
1237
1266
  }
1238
1267
 
@@ -1246,7 +1275,7 @@ pgconn_query_assign_typemap( VALUE self, struct query_params_data *paramsData )
1246
1275
  * It's not recommended to use explicit sync or async variants but #exec_params instead, unless you have a good reason to do so.
1247
1276
  */
1248
1277
  static VALUE
1249
- pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1278
+ pgconn_sync_exec_params( int argc, VALUE *argv, VALUE self )
1250
1279
  {
1251
1280
  t_pg_connection *this = pg_get_connection_safe( self );
1252
1281
  PGresult *result = NULL;
@@ -1266,7 +1295,7 @@ pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1266
1295
  */
1267
1296
  if ( NIL_P(paramsData.params) ) {
1268
1297
  pg_deprecated(1, ("forwarding exec_params to exec is deprecated"));
1269
- return pgconn_exec( 1, argv, self );
1298
+ return pgconn_sync_exec( 1, argv, self );
1270
1299
  }
1271
1300
  pgconn_query_assign_typemap( self, &paramsData );
1272
1301
 
@@ -1297,7 +1326,7 @@ pgconn_exec_params( int argc, VALUE *argv, VALUE self )
1297
1326
  * It's not recommended to use explicit sync or async variants but #prepare instead, unless you have a good reason to do so.
1298
1327
  */
1299
1328
  static VALUE
1300
- pgconn_prepare(int argc, VALUE *argv, VALUE self)
1329
+ pgconn_sync_prepare(int argc, VALUE *argv, VALUE self)
1301
1330
  {
1302
1331
  t_pg_connection *this = pg_get_connection_safe( self );
1303
1332
  PGresult *result = NULL;
@@ -1346,7 +1375,7 @@ pgconn_prepare(int argc, VALUE *argv, VALUE self)
1346
1375
  * It's not recommended to use explicit sync or async variants but #exec_prepared instead, unless you have a good reason to do so.
1347
1376
  */
1348
1377
  static VALUE
1349
- pgconn_exec_prepared(int argc, VALUE *argv, VALUE self)
1378
+ pgconn_sync_exec_prepared(int argc, VALUE *argv, VALUE self)
1350
1379
  {
1351
1380
  t_pg_connection *this = pg_get_connection_safe( self );
1352
1381
  PGresult *result = NULL;
@@ -1391,7 +1420,7 @@ pgconn_exec_prepared(int argc, VALUE *argv, VALUE self)
1391
1420
  * It's not recommended to use explicit sync or async variants but #describe_prepared instead, unless you have a good reason to do so.
1392
1421
  */
1393
1422
  static VALUE
1394
- pgconn_describe_prepared(VALUE self, VALUE stmt_name)
1423
+ pgconn_sync_describe_prepared(VALUE self, VALUE stmt_name)
1395
1424
  {
1396
1425
  PGresult *result;
1397
1426
  VALUE rb_pgresult;
@@ -1419,7 +1448,7 @@ pgconn_describe_prepared(VALUE self, VALUE stmt_name)
1419
1448
  * It's not recommended to use explicit sync or async variants but #describe_portal instead, unless you have a good reason to do so.
1420
1449
  */
1421
1450
  static VALUE
1422
- pgconn_describe_portal(self, stmt_name)
1451
+ pgconn_sync_describe_portal(self, stmt_name)
1423
1452
  VALUE self, stmt_name;
1424
1453
  {
1425
1454
  PGresult *result;
@@ -1454,6 +1483,9 @@ pgconn_describe_portal(self, stmt_name)
1454
1483
  * * +PGRES_NONFATAL_ERROR+
1455
1484
  * * +PGRES_FATAL_ERROR+
1456
1485
  * * +PGRES_COPY_BOTH+
1486
+ * * +PGRES_SINGLE_TUPLE+
1487
+ * * +PGRES_PIPELINE_SYNC+
1488
+ * * +PGRES_PIPELINE_ABORTED+
1457
1489
  */
1458
1490
  static VALUE
1459
1491
  pgconn_make_empty_pgresult(VALUE self, VALUE status)
@@ -1750,6 +1782,7 @@ pgconn_send_query(int argc, VALUE *argv, VALUE self)
1750
1782
  rb_iv_set(error, "@connection", self);
1751
1783
  rb_exc_raise(error);
1752
1784
  }
1785
+ pgconn_wait_for_flush( self );
1753
1786
  return Qnil;
1754
1787
  }
1755
1788
 
@@ -1779,7 +1812,7 @@ pgconn_send_query(int argc, VALUE *argv, VALUE self)
1779
1812
  * or, it may be a String. If it is a string, that is equivalent to the hash:
1780
1813
  * { :value => <string value>, :type => 0, :format => 0 }
1781
1814
  *
1782
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1815
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1783
1816
  * inside the SQL query. The 0th element of the +params+ array is bound
1784
1817
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
1785
1818
  *
@@ -1827,6 +1860,7 @@ pgconn_send_query_params(int argc, VALUE *argv, VALUE self)
1827
1860
  rb_iv_set(error, "@connection", self);
1828
1861
  rb_exc_raise(error);
1829
1862
  }
1863
+ pgconn_wait_for_flush( self );
1830
1864
  return Qnil;
1831
1865
  }
1832
1866
 
@@ -1847,7 +1881,7 @@ pgconn_send_query_params(int argc, VALUE *argv, VALUE self)
1847
1881
  *
1848
1882
  * For example: "SELECT $1::int"
1849
1883
  *
1850
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1884
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1851
1885
  * inside the SQL query.
1852
1886
  */
1853
1887
  static VALUE
@@ -1890,6 +1924,7 @@ pgconn_send_prepare(int argc, VALUE *argv, VALUE self)
1890
1924
  rb_iv_set(error, "@connection", self);
1891
1925
  rb_exc_raise(error);
1892
1926
  }
1927
+ pgconn_wait_for_flush( self );
1893
1928
  return Qnil;
1894
1929
  }
1895
1930
 
@@ -1911,7 +1946,7 @@ pgconn_send_prepare(int argc, VALUE *argv, VALUE self)
1911
1946
  * or, it may be a String. If it is a string, that is equivalent to the hash:
1912
1947
  * { :value => <string value>, :format => 0 }
1913
1948
  *
1914
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
1949
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
1915
1950
  * inside the SQL query. The 0th element of the +params+ array is bound
1916
1951
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
1917
1952
  *
@@ -1941,7 +1976,6 @@ pgconn_send_query_prepared(int argc, VALUE *argv, VALUE self)
1941
1976
 
1942
1977
  if(NIL_P(paramsData.params)) {
1943
1978
  paramsData.params = rb_ary_new2(0);
1944
- resultFormat = 0;
1945
1979
  }
1946
1980
  pgconn_query_assign_typemap( self, &paramsData );
1947
1981
 
@@ -1959,6 +1993,7 @@ pgconn_send_query_prepared(int argc, VALUE *argv, VALUE self)
1959
1993
  rb_iv_set(error, "@connection", self);
1960
1994
  rb_exc_raise(error);
1961
1995
  }
1996
+ pgconn_wait_for_flush( self );
1962
1997
  return Qnil;
1963
1998
  }
1964
1999
 
@@ -1980,6 +2015,7 @@ pgconn_send_describe_prepared(VALUE self, VALUE stmt_name)
1980
2015
  rb_iv_set(error, "@connection", self);
1981
2016
  rb_exc_raise(error);
1982
2017
  }
2018
+ pgconn_wait_for_flush( self );
1983
2019
  return Qnil;
1984
2020
  }
1985
2021
 
@@ -2002,28 +2038,13 @@ pgconn_send_describe_portal(VALUE self, VALUE portal)
2002
2038
  rb_iv_set(error, "@connection", self);
2003
2039
  rb_exc_raise(error);
2004
2040
  }
2041
+ pgconn_wait_for_flush( self );
2005
2042
  return Qnil;
2006
2043
  }
2007
2044
 
2008
2045
 
2009
- /*
2010
- * call-seq:
2011
- * conn.get_result() -> PG::Result
2012
- * conn.get_result() {|pg_result| block }
2013
- *
2014
- * Blocks waiting for the next result from a call to
2015
- * #send_query (or another asynchronous command), and returns
2016
- * it. Returns +nil+ if no more results are available.
2017
- *
2018
- * Note: call this function repeatedly until it returns +nil+, or else
2019
- * you will not be able to issue further commands.
2020
- *
2021
- * If the optional code block is given, it will be passed <i>result</i> as an argument,
2022
- * and the PG::Result object will automatically be cleared when the block terminates.
2023
- * In this instance, <code>conn.exec</code> returns the value of the block.
2024
- */
2025
2046
  static VALUE
2026
- pgconn_get_result(VALUE self)
2047
+ pgconn_sync_get_result(VALUE self)
2027
2048
  {
2028
2049
  PGconn *conn = pg_get_pgconn(self);
2029
2050
  PGresult *result;
@@ -2056,6 +2077,7 @@ pgconn_consume_input(self)
2056
2077
  PGconn *conn = pg_get_pgconn(self);
2057
2078
  /* returns 0 on error */
2058
2079
  if(PQconsumeInput(conn) == 0) {
2080
+ pgconn_close_socket_io(self);
2059
2081
  error = rb_exc_new2(rb_eConnectionBad, PQerrorMessage(conn));
2060
2082
  rb_iv_set(error, "@connection", self);
2061
2083
  rb_exc_raise(error);
@@ -2068,7 +2090,7 @@ pgconn_consume_input(self)
2068
2090
  * conn.is_busy() -> Boolean
2069
2091
  *
2070
2092
  * Returns +true+ if a command is busy, that is, if
2071
- * PQgetResult would block. Otherwise returns +false+.
2093
+ * #get_result would block. Otherwise returns +false+.
2072
2094
  */
2073
2095
  static VALUE
2074
2096
  pgconn_is_busy(self)
@@ -2077,24 +2099,8 @@ pgconn_is_busy(self)
2077
2099
  return gvl_PQisBusy(pg_get_pgconn(self)) ? Qtrue : Qfalse;
2078
2100
  }
2079
2101
 
2080
- /*
2081
- * call-seq:
2082
- * conn.setnonblocking(Boolean) -> nil
2083
- *
2084
- * Sets the nonblocking status of the connection.
2085
- * In the blocking state, calls to #send_query
2086
- * will block until the message is sent to the server,
2087
- * but will not wait for the query results.
2088
- * In the nonblocking state, calls to #send_query
2089
- * will return an error if the socket is not ready for
2090
- * writing.
2091
- * Note: This function does not affect #exec, because
2092
- * that function doesn't return until the server has
2093
- * processed the query and returned the results.
2094
- * Returns +nil+.
2095
- */
2096
2102
  static VALUE
2097
- pgconn_setnonblocking(self, state)
2103
+ pgconn_sync_setnonblocking(self, state)
2098
2104
  VALUE self, state;
2099
2105
  {
2100
2106
  int arg;
@@ -2116,33 +2122,15 @@ pgconn_setnonblocking(self, state)
2116
2122
  }
2117
2123
 
2118
2124
 
2119
- /*
2120
- * call-seq:
2121
- * conn.isnonblocking() -> Boolean
2122
- *
2123
- * Returns +true+ if a command is busy, that is, if
2124
- * PQgetResult would block. Otherwise returns +false+.
2125
- */
2126
2125
  static VALUE
2127
- pgconn_isnonblocking(self)
2126
+ pgconn_sync_isnonblocking(self)
2128
2127
  VALUE self;
2129
2128
  {
2130
2129
  return PQisnonblocking(pg_get_pgconn(self)) ? Qtrue : Qfalse;
2131
2130
  }
2132
2131
 
2133
- /*
2134
- * call-seq:
2135
- * conn.flush() -> Boolean
2136
- *
2137
- * Attempts to flush any queued output data to the server.
2138
- * Returns +true+ if data is successfully flushed, +false+
2139
- * if not (can only return +false+ if connection is
2140
- * nonblocking.
2141
- * Raises PG::Error if some other failure occurred.
2142
- */
2143
2132
  static VALUE
2144
- pgconn_flush(self)
2145
- VALUE self;
2133
+ pgconn_sync_flush(VALUE self)
2146
2134
  {
2147
2135
  PGconn *conn = pg_get_pgconn(self);
2148
2136
  int ret;
@@ -2156,18 +2144,8 @@ pgconn_flush(self)
2156
2144
  return (ret) ? Qfalse : Qtrue;
2157
2145
  }
2158
2146
 
2159
- /*
2160
- * call-seq:
2161
- * conn.cancel() -> String
2162
- *
2163
- * Requests cancellation of the command currently being
2164
- * processed. (Only implemented in PostgreSQL >= 8.0)
2165
- *
2166
- * Returns +nil+ on success, or a string containing the
2167
- * error message if a failure occurs.
2168
- */
2169
2147
  static VALUE
2170
- pgconn_cancel(VALUE self)
2148
+ pgconn_sync_cancel(VALUE self)
2171
2149
  {
2172
2150
  char errbuf[256];
2173
2151
  PGcancel *cancel;
@@ -2178,7 +2156,7 @@ pgconn_cancel(VALUE self)
2178
2156
  if(cancel == NULL)
2179
2157
  rb_raise(rb_ePGerror,"Invalid connection!");
2180
2158
 
2181
- ret = gvl_PQcancel(cancel, errbuf, 256);
2159
+ ret = gvl_PQcancel(cancel, errbuf, sizeof(errbuf));
2182
2160
  if(ret == 1)
2183
2161
  retval = Qnil;
2184
2162
  else
@@ -2229,55 +2207,67 @@ pgconn_notifies(VALUE self)
2229
2207
  return hash;
2230
2208
  }
2231
2209
 
2232
- /* Win32 + Ruby 1.9+ */
2233
- #if defined( _WIN32 )
2234
- /*
2235
- * On Windows, use platform-specific strategies to wait for the socket
2236
- * instead of rb_wait_for_single_fd().
2210
+ #if defined(_WIN32)
2211
+
2212
+ /* We use a specialized implementation of rb_io_wait() on Windows.
2213
+ * This is because rb_io_wait() and rb_wait_for_single_fd() are very slow on Windows.
2237
2214
  */
2238
2215
 
2216
+ #if defined(HAVE_RUBY_FIBER_SCHEDULER_H)
2217
+ #include <ruby/fiber/scheduler.h>
2218
+ #endif
2219
+
2220
+ typedef enum {
2221
+ PG_RUBY_IO_READABLE = RB_WAITFD_IN,
2222
+ PG_RUBY_IO_WRITABLE = RB_WAITFD_OUT,
2223
+ PG_RUBY_IO_PRIORITY = RB_WAITFD_PRI,
2224
+ } pg_rb_io_event_t;
2225
+
2239
2226
  int rb_w32_wait_events( HANDLE *events, int num, DWORD timeout );
2240
2227
 
2241
- static void *
2242
- wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readable)(PGconn *) )
2243
- {
2244
- int sd = PQsocket( conn );
2245
- void *retval;
2228
+ static VALUE
2229
+ pg_rb_thread_io_wait(VALUE io, VALUE events, VALUE timeout) {
2230
+ rb_io_t *fptr;
2231
+ struct timeval ptimeout;
2232
+
2246
2233
  struct timeval aborttime={0,0}, currtime, waittime;
2247
2234
  DWORD timeout_milisec = INFINITE;
2248
- DWORD wait_ret;
2249
- WSAEVENT hEvent;
2235
+ HANDLE hEvent = WSACreateEvent();
2250
2236
 
2251
- if ( sd < 0 )
2252
- rb_raise(rb_eConnectionBad, "PQsocket() can't get socket descriptor");
2237
+ long rb_events = NUM2UINT(events);
2238
+ long w32_events = 0;
2239
+ DWORD wait_ret;
2253
2240
 
2254
- hEvent = WSACreateEvent();
2241
+ GetOpenFile((io), fptr);
2242
+ if( !NIL_P(timeout) ){
2243
+ ptimeout.tv_sec = (time_t)(NUM2DBL(timeout));
2244
+ ptimeout.tv_usec = (time_t)(NUM2DBL(timeout) - (double)ptimeout.tv_sec);
2255
2245
 
2256
- /* Check for connection errors (PQisBusy is true on connection errors) */
2257
- if( PQconsumeInput(conn) == 0 ) {
2258
- WSACloseEvent( hEvent );
2259
- rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2246
+ gettimeofday(&currtime, NULL);
2247
+ timeradd(&currtime, &ptimeout, &aborttime);
2260
2248
  }
2261
2249
 
2262
- if ( ptimeout ) {
2263
- gettimeofday(&currtime, NULL);
2264
- timeradd(&currtime, ptimeout, &aborttime);
2250
+ if(rb_events & PG_RUBY_IO_READABLE) {
2251
+ w32_events |= FD_READ | FD_ACCEPT | FD_CLOSE;
2252
+ } else if(rb_events & PG_RUBY_IO_WRITABLE) {
2253
+ w32_events |= FD_WRITE | FD_CONNECT;
2254
+ } else if(rb_events & PG_RUBY_IO_PRIORITY) {
2255
+ w32_events |= FD_OOB;
2265
2256
  }
2266
2257
 
2267
- while ( !(retval=is_readable(conn)) ) {
2268
- if ( WSAEventSelect(sd, hEvent, FD_READ|FD_CLOSE) == SOCKET_ERROR ) {
2258
+ for(;;) {
2259
+ if ( WSAEventSelect(_get_osfhandle(fptr->fd), hEvent, w32_events) == SOCKET_ERROR ) {
2269
2260
  WSACloseEvent( hEvent );
2270
2261
  rb_raise( rb_eConnectionBad, "WSAEventSelect socket error: %d", WSAGetLastError() );
2271
2262
  }
2272
2263
 
2273
- if ( ptimeout ) {
2264
+ if ( !NIL_P(timeout) ) {
2274
2265
  gettimeofday(&currtime, NULL);
2275
2266
  timersub(&aborttime, &currtime, &waittime);
2276
2267
  timeout_milisec = (DWORD)( waittime.tv_sec * 1e3 + waittime.tv_usec / 1e3 );
2277
2268
  }
2278
2269
 
2279
- /* Is the given timeout valid? */
2280
- if( !ptimeout || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2270
+ if( NIL_P(timeout) || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2281
2271
  /* Wait for the socket to become readable before checking again */
2282
2272
  wait_ret = rb_w32_wait_events( &hEvent, 1, timeout_milisec );
2283
2273
  } else {
@@ -2286,9 +2276,11 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2286
2276
 
2287
2277
  if ( wait_ret == WAIT_TIMEOUT ) {
2288
2278
  WSACloseEvent( hEvent );
2289
- return NULL;
2279
+ return UINT2NUM(0);
2290
2280
  } else if ( wait_ret == WAIT_OBJECT_0 ) {
2281
+ WSACloseEvent( hEvent );
2291
2282
  /* The event we were waiting for. */
2283
+ return UINT2NUM(rb_events);
2292
2284
  } else if ( wait_ret == WAIT_OBJECT_0 + 1) {
2293
2285
  /* This indicates interruption from timer thread, GC, exception
2294
2286
  * from other threads etc... */
@@ -2300,36 +2292,75 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2300
2292
  WSACloseEvent( hEvent );
2301
2293
  rb_raise( rb_eConnectionBad, "Wait on socket abandoned (WaitForMultipleObjects)" );
2302
2294
  }
2303
-
2304
- /* Check for connection errors (PQisBusy is true on connection errors) */
2305
- if ( PQconsumeInput(conn) == 0 ) {
2306
- WSACloseEvent( hEvent );
2307
- rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2308
- }
2309
2295
  }
2296
+ }
2310
2297
 
2311
- WSACloseEvent( hEvent );
2312
- return retval;
2298
+ static VALUE
2299
+ pg_rb_io_wait(VALUE io, VALUE events, VALUE timeout) {
2300
+ #if defined(HAVE_RUBY_FIBER_SCHEDULER_H)
2301
+ /* We don't support Fiber.scheduler on Windows ruby-3.0 because there is no fast way to check whether a scheduler is active.
2302
+ * Fortunatelly ruby-3.1 offers a C-API for it.
2303
+ */
2304
+ VALUE scheduler = rb_fiber_scheduler_current();
2305
+
2306
+ if (!NIL_P(scheduler)) {
2307
+ return rb_io_wait(io, events, timeout);
2308
+ }
2309
+ #endif
2310
+ return pg_rb_thread_io_wait(io, events, timeout);
2313
2311
  }
2314
2312
 
2313
+ #elif defined(HAVE_RB_IO_WAIT)
2314
+
2315
+ /* Use our own function and constants names, to avoid conflicts with truffleruby-head on its road to ruby-3.0 compatibility. */
2316
+ #define pg_rb_io_wait rb_io_wait
2317
+ #define PG_RUBY_IO_READABLE RUBY_IO_READABLE
2318
+ #define PG_RUBY_IO_WRITABLE RUBY_IO_WRITABLE
2319
+ #define PG_RUBY_IO_PRIORITY RUBY_IO_PRIORITY
2320
+
2315
2321
  #else
2322
+ /* For compat with ruby < 3.0 */
2323
+
2324
+ typedef enum {
2325
+ PG_RUBY_IO_READABLE = RB_WAITFD_IN,
2326
+ PG_RUBY_IO_WRITABLE = RB_WAITFD_OUT,
2327
+ PG_RUBY_IO_PRIORITY = RB_WAITFD_PRI,
2328
+ } pg_rb_io_event_t;
2329
+
2330
+ static VALUE
2331
+ pg_rb_io_wait(VALUE io, VALUE events, VALUE timeout) {
2332
+ rb_io_t *fptr;
2333
+ struct timeval waittime;
2334
+ int res;
2335
+
2336
+ GetOpenFile((io), fptr);
2337
+ if( !NIL_P(timeout) ){
2338
+ waittime.tv_sec = (time_t)(NUM2DBL(timeout));
2339
+ waittime.tv_usec = (time_t)(NUM2DBL(timeout) - (double)waittime.tv_sec);
2340
+ }
2341
+ res = rb_wait_for_single_fd(fptr->fd, NUM2UINT(events), NIL_P(timeout) ? NULL : &waittime);
2316
2342
 
2317
- /* non Win32 */
2343
+ return UINT2NUM(res);
2344
+ }
2345
+ #endif
2318
2346
 
2319
2347
  static void *
2320
- wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readable)(PGconn *))
2348
+ wait_socket_readable( VALUE self, struct timeval *ptimeout, void *(*is_readable)(PGconn *))
2321
2349
  {
2322
- int sd = PQsocket( conn );
2323
- int ret;
2350
+ VALUE socket_io;
2351
+ VALUE ret;
2324
2352
  void *retval;
2325
2353
  struct timeval aborttime={0,0}, currtime, waittime;
2354
+ VALUE wait_timeout = Qnil;
2355
+ PGconn *conn = pg_get_pgconn(self);
2326
2356
 
2327
- if ( sd < 0 )
2328
- rb_raise(rb_eConnectionBad, "PQsocket() can't get socket descriptor");
2357
+ socket_io = pgconn_socket_io(self);
2329
2358
 
2330
2359
  /* Check for connection errors (PQisBusy is true on connection errors) */
2331
- if ( PQconsumeInput(conn) == 0 )
2360
+ if ( PQconsumeInput(conn) == 0 ) {
2361
+ pgconn_close_socket_io(self);
2332
2362
  rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2363
+ }
2333
2364
 
2334
2365
  if ( ptimeout ) {
2335
2366
  gettimeofday(&currtime, NULL);
@@ -2340,27 +2371,25 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2340
2371
  if ( ptimeout ) {
2341
2372
  gettimeofday(&currtime, NULL);
2342
2373
  timersub(&aborttime, &currtime, &waittime);
2374
+ wait_timeout = DBL2NUM((double)(waittime.tv_sec) + (double)(waittime.tv_usec) / 1000000.0);
2343
2375
  }
2344
2376
 
2345
2377
  /* Is the given timeout valid? */
2346
2378
  if( !ptimeout || (waittime.tv_sec >= 0 && waittime.tv_usec >= 0) ){
2347
2379
  /* Wait for the socket to become readable before checking again */
2348
- ret = rb_wait_for_single_fd( sd, RB_WAITFD_IN, ptimeout ? &waittime : NULL );
2380
+ ret = pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), wait_timeout);
2349
2381
  } else {
2350
- ret = 0;
2351
- }
2352
-
2353
- if ( ret < 0 ){
2354
- rb_sys_fail( "rb_wait_for_single_fd()" );
2382
+ ret = Qfalse;
2355
2383
  }
2356
2384
 
2357
2385
  /* Return false if the select() timed out */
2358
- if ( ret == 0 ){
2386
+ if ( ret == Qfalse ){
2359
2387
  return NULL;
2360
2388
  }
2361
2389
 
2362
2390
  /* Check for connection errors (PQisBusy is true on connection errors) */
2363
2391
  if ( PQconsumeInput(conn) == 0 ){
2392
+ pgconn_close_socket_io(self);
2364
2393
  rb_raise( rb_eConnectionBad, "PQconsumeInput() %s", PQerrorMessage(conn) );
2365
2394
  }
2366
2395
  }
@@ -2368,8 +2397,45 @@ wait_socket_readable( PGconn *conn, struct timeval *ptimeout, void *(*is_readabl
2368
2397
  return retval;
2369
2398
  }
2370
2399
 
2400
+ /*
2401
+ * call-seq:
2402
+ * conn.flush() -> Boolean
2403
+ *
2404
+ * Attempts to flush any queued output data to the server.
2405
+ * Returns +true+ if data is successfully flushed, +false+
2406
+ * if not (can only return +false+ if connection is
2407
+ * nonblocking.
2408
+ * Raises PG::Error if some other failure occurred.
2409
+ */
2410
+ static VALUE
2411
+ pgconn_async_flush(VALUE self)
2412
+ {
2413
+ while( pgconn_sync_flush(self) == Qfalse ){
2414
+ /* wait for the socket to become read- or write-ready */
2415
+ int events;
2416
+ VALUE socket_io = pgconn_socket_io(self);
2417
+ events = RB_NUM2INT(pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE | PG_RUBY_IO_WRITABLE), Qnil));
2371
2418
 
2372
- #endif
2419
+ if (events & PG_RUBY_IO_READABLE)
2420
+ pgconn_consume_input(self);
2421
+ }
2422
+ return Qtrue;
2423
+ }
2424
+
2425
+ static VALUE
2426
+ pgconn_wait_for_flush( VALUE self ){
2427
+ if( !pg_get_connection_safe(self)->flush_data )
2428
+ return Qnil;
2429
+
2430
+ return pgconn_async_flush(self);
2431
+ }
2432
+
2433
+ static VALUE
2434
+ pgconn_flush_data_set( VALUE self, VALUE enabled ){
2435
+ t_pg_connection *conn = pg_get_connection(self);
2436
+ conn->flush_data = RTEST(enabled);
2437
+ return enabled;
2438
+ }
2373
2439
 
2374
2440
  static void *
2375
2441
  notify_readable(PGconn *conn)
@@ -2408,7 +2474,7 @@ pgconn_wait_for_notify(int argc, VALUE *argv, VALUE self)
2408
2474
  ptimeout = &timeout;
2409
2475
  }
2410
2476
 
2411
- pnotification = (PGnotify*) wait_socket_readable( this->pgconn, ptimeout, notify_readable);
2477
+ pnotification = (PGnotify*) wait_socket_readable( self, ptimeout, notify_readable);
2412
2478
 
2413
2479
  /* Return nil if the select timed out */
2414
2480
  if ( !pnotification ) return Qnil;
@@ -2429,28 +2495,8 @@ pgconn_wait_for_notify(int argc, VALUE *argv, VALUE self)
2429
2495
  }
2430
2496
 
2431
2497
 
2432
- /*
2433
- * call-seq:
2434
- * conn.put_copy_data( buffer [, encoder] ) -> Boolean
2435
- *
2436
- * Transmits _buffer_ as copy data to the server.
2437
- * Returns true if the data was sent, false if it was
2438
- * not sent (false is only possible if the connection
2439
- * is in nonblocking mode, and this command would block).
2440
- *
2441
- * _encoder_ can be a PG::Coder derivation (typically PG::TextEncoder::CopyRow).
2442
- * This encodes the data fields given as _buffer_ from an Array of Strings to
2443
- * PostgreSQL's COPY text format inclusive proper escaping. Optionally
2444
- * the encoder can type cast the fields from various Ruby types in one step,
2445
- * if PG::TextEncoder::CopyRow#type_map is set accordingly.
2446
- *
2447
- * Raises an exception if an error occurs.
2448
- *
2449
- * See also #copy_data.
2450
- *
2451
- */
2452
2498
  static VALUE
2453
- pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2499
+ pgconn_sync_put_copy_data(int argc, VALUE *argv, VALUE self)
2454
2500
  {
2455
2501
  int ret;
2456
2502
  int len;
@@ -2467,13 +2513,11 @@ pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2467
2513
  if( NIL_P(this->encoder_for_put_copy_data) ){
2468
2514
  buffer = value;
2469
2515
  } else {
2470
- p_coder = DATA_PTR( this->encoder_for_put_copy_data );
2516
+ p_coder = RTYPEDDATA_DATA( this->encoder_for_put_copy_data );
2471
2517
  }
2472
- } else if( rb_obj_is_kind_of(encoder, rb_cPG_Coder) ) {
2473
- Data_Get_Struct( encoder, t_pg_coder, p_coder );
2474
2518
  } else {
2475
- rb_raise( rb_eTypeError, "wrong encoder type %s (expected some kind of PG::Coder)",
2476
- rb_obj_classname( encoder ) );
2519
+ /* Check argument type and use argument encoder */
2520
+ TypedData_Get_Struct(encoder, t_pg_coder, &pg_coder_type, p_coder);
2477
2521
  }
2478
2522
 
2479
2523
  if( p_coder ){
@@ -2507,22 +2551,8 @@ pgconn_put_copy_data(int argc, VALUE *argv, VALUE self)
2507
2551
  return (ret) ? Qtrue : Qfalse;
2508
2552
  }
2509
2553
 
2510
- /*
2511
- * call-seq:
2512
- * conn.put_copy_end( [ error_message ] ) -> Boolean
2513
- *
2514
- * Sends end-of-data indication to the server.
2515
- *
2516
- * _error_message_ is an optional parameter, and if set,
2517
- * forces the COPY command to fail with the string
2518
- * _error_message_.
2519
- *
2520
- * Returns true if the end-of-data was sent, false if it was
2521
- * not sent (false is only possible if the connection
2522
- * is in nonblocking mode, and this command would block).
2523
- */
2524
2554
  static VALUE
2525
- pgconn_put_copy_end(int argc, VALUE *argv, VALUE self)
2555
+ pgconn_sync_put_copy_end(int argc, VALUE *argv, VALUE self)
2526
2556
  {
2527
2557
  VALUE str;
2528
2558
  VALUE error;
@@ -2544,27 +2574,8 @@ pgconn_put_copy_end(int argc, VALUE *argv, VALUE self)
2544
2574
  return (ret) ? Qtrue : Qfalse;
2545
2575
  }
2546
2576
 
2547
- /*
2548
- * call-seq:
2549
- * conn.get_copy_data( [ async = false [, decoder = nil ]] ) -> Object
2550
- *
2551
- * Return one row of data, +nil+
2552
- * if the copy is done, or +false+ if the call would
2553
- * block (only possible if _async_ is true).
2554
- *
2555
- * If _decoder_ is not set or +nil+, data is returned as binary string.
2556
- *
2557
- * If _decoder_ is set to a PG::Coder derivation, the return type depends on this decoder.
2558
- * PG::TextDecoder::CopyRow decodes the received data fields from one row of PostgreSQL's
2559
- * COPY text format to an Array of Strings.
2560
- * Optionally the decoder can type cast the single fields to various Ruby types in one step,
2561
- * if PG::TextDecoder::CopyRow#type_map is set accordingly.
2562
- *
2563
- * See also #copy_data.
2564
- *
2565
- */
2566
2577
  static VALUE
2567
- pgconn_get_copy_data(int argc, VALUE *argv, VALUE self )
2578
+ pgconn_sync_get_copy_data(int argc, VALUE *argv, VALUE self )
2568
2579
  {
2569
2580
  VALUE async_in;
2570
2581
  VALUE error;
@@ -2579,13 +2590,11 @@ pgconn_get_copy_data(int argc, VALUE *argv, VALUE self )
2579
2590
 
2580
2591
  if( NIL_P(decoder) ){
2581
2592
  if( !NIL_P(this->decoder_for_get_copy_data) ){
2582
- p_coder = DATA_PTR( this->decoder_for_get_copy_data );
2593
+ p_coder = RTYPEDDATA_DATA( this->decoder_for_get_copy_data );
2583
2594
  }
2584
- } else if( rb_obj_is_kind_of(decoder, rb_cPG_Coder) ) {
2585
- Data_Get_Struct( decoder, t_pg_coder, p_coder );
2586
2595
  } else {
2587
- rb_raise( rb_eTypeError, "wrong decoder type %s (expected some kind of PG::Coder)",
2588
- rb_obj_classname( decoder ) );
2596
+ /* Check argument type and use argument decoder */
2597
+ TypedData_Get_Struct(decoder, t_pg_coder, &pg_coder_type, p_coder);
2589
2598
  }
2590
2599
 
2591
2600
  ret = gvl_PQgetCopyData(this->pgconn, &buffer, RTEST(async_in));
@@ -2830,7 +2839,7 @@ notice_processor_proxy(void *arg, const char *message)
2830
2839
  * call-seq:
2831
2840
  * conn.set_notice_processor {|message| ... } -> Proc
2832
2841
  *
2833
- * See #set_notice_receiver for the desription of what this and the
2842
+ * See #set_notice_receiver for the description of what this and the
2834
2843
  * notice_processor methods do.
2835
2844
  *
2836
2845
  * This function takes a new block to act as the notice processor and returns
@@ -2884,12 +2893,14 @@ pgconn_get_client_encoding(VALUE self)
2884
2893
 
2885
2894
  /*
2886
2895
  * call-seq:
2887
- * conn.set_client_encoding( encoding )
2896
+ * conn.sync_set_client_encoding( encoding )
2888
2897
  *
2889
- * Sets the client encoding to the _encoding_ String.
2898
+ * This function has the same behavior as #async_set_client_encoding, but is implemented using the synchronous command processing API of libpq.
2899
+ * See #async_exec for the differences between the two API variants.
2900
+ * It's not recommended to use explicit sync or async variants but #set_client_encoding instead, unless you have a good reason to do so.
2890
2901
  */
2891
2902
  static VALUE
2892
- pgconn_set_client_encoding(VALUE self, VALUE str)
2903
+ pgconn_sync_set_client_encoding(VALUE self, VALUE str)
2893
2904
  {
2894
2905
  PGconn *conn = pg_get_pgconn( self );
2895
2906
 
@@ -2903,49 +2914,6 @@ pgconn_set_client_encoding(VALUE self, VALUE str)
2903
2914
  return Qnil;
2904
2915
  }
2905
2916
 
2906
- /*
2907
- * call-seq:
2908
- * conn.transaction { |conn| ... } -> result of the block
2909
- *
2910
- * Executes a +BEGIN+ at the start of the block,
2911
- * and a +COMMIT+ at the end of the block, or
2912
- * +ROLLBACK+ if any exception occurs.
2913
- */
2914
- static VALUE
2915
- pgconn_transaction(VALUE self)
2916
- {
2917
- PGconn *conn = pg_get_pgconn(self);
2918
- PGresult *result;
2919
- VALUE rb_pgresult;
2920
- VALUE block_result = Qnil;
2921
- int status;
2922
-
2923
- if (rb_block_given_p()) {
2924
- result = gvl_PQexec(conn, "BEGIN");
2925
- rb_pgresult = pg_new_result(result, self);
2926
- pg_result_check(rb_pgresult);
2927
- block_result = rb_protect(rb_yield, self, &status);
2928
- if(status == 0) {
2929
- result = gvl_PQexec(conn, "COMMIT");
2930
- rb_pgresult = pg_new_result(result, self);
2931
- pg_result_check(rb_pgresult);
2932
- }
2933
- else {
2934
- /* exception occurred, ROLLBACK and re-raise */
2935
- result = gvl_PQexec(conn, "ROLLBACK");
2936
- rb_pgresult = pg_new_result(result, self);
2937
- pg_result_check(rb_pgresult);
2938
- rb_jump_tag(status);
2939
- }
2940
-
2941
- }
2942
- else {
2943
- /* no block supplied? */
2944
- rb_raise(rb_eArgError, "Must supply block for PG::Connection#transaction");
2945
- }
2946
- return block_result;
2947
- }
2948
-
2949
2917
 
2950
2918
  /*
2951
2919
  * call-seq:
@@ -3022,8 +2990,6 @@ get_result_readable(PGconn *conn)
3022
2990
  */
3023
2991
  static VALUE
3024
2992
  pgconn_block( int argc, VALUE *argv, VALUE self ) {
3025
- PGconn *conn = pg_get_pgconn( self );
3026
-
3027
2993
  struct timeval timeout;
3028
2994
  struct timeval *ptimeout = NULL;
3029
2995
  VALUE timeout_in;
@@ -3037,7 +3003,7 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3037
3003
  ptimeout = &timeout;
3038
3004
  }
3039
3005
 
3040
- ret = wait_socket_readable( conn, ptimeout, get_result_readable);
3006
+ ret = wait_socket_readable( self, ptimeout, get_result_readable);
3041
3007
 
3042
3008
  if( !ret )
3043
3009
  return Qfalse;
@@ -3046,6 +3012,42 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3046
3012
  }
3047
3013
 
3048
3014
 
3015
+ /*
3016
+ * call-seq:
3017
+ * conn.sync_get_last_result( ) -> PG::Result
3018
+ *
3019
+ * This function has the same behavior as #async_get_last_result, but is implemented using the synchronous command processing API of libpq.
3020
+ * See #async_exec for the differences between the two API variants.
3021
+ * It's not recommended to use explicit sync or async variants but #get_last_result instead, unless you have a good reason to do so.
3022
+ */
3023
+ static VALUE
3024
+ pgconn_sync_get_last_result(VALUE self)
3025
+ {
3026
+ PGconn *conn = pg_get_pgconn(self);
3027
+ VALUE rb_pgresult = Qnil;
3028
+ PGresult *cur, *prev;
3029
+
3030
+
3031
+ cur = prev = NULL;
3032
+ while ((cur = gvl_PQgetResult(conn)) != NULL) {
3033
+ int status;
3034
+
3035
+ if (prev) PQclear(prev);
3036
+ prev = cur;
3037
+
3038
+ status = PQresultStatus(cur);
3039
+ if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN || status == PGRES_COPY_BOTH)
3040
+ break;
3041
+ }
3042
+
3043
+ if (prev) {
3044
+ rb_pgresult = pg_new_result( prev, self );
3045
+ pg_result_check(rb_pgresult);
3046
+ }
3047
+
3048
+ return rb_pgresult;
3049
+ }
3050
+
3049
3051
  /*
3050
3052
  * call-seq:
3051
3053
  * conn.get_last_result( ) -> PG::Result
@@ -3056,27 +3058,35 @@ pgconn_block( int argc, VALUE *argv, VALUE self ) {
3056
3058
  * returns the last non-NULL result, or +nil+ if no
3057
3059
  * results are available.
3058
3060
  *
3061
+ * If the last result contains a bad result_status, an
3062
+ * appropriate exception is raised.
3063
+ *
3059
3064
  * This function is similar to #get_result
3060
3065
  * except that it is designed to get one and only
3061
- * one result.
3066
+ * one result and that it checks the result state.
3062
3067
  */
3063
3068
  static VALUE
3064
- pgconn_get_last_result(VALUE self)
3069
+ pgconn_async_get_last_result(VALUE self)
3065
3070
  {
3066
3071
  PGconn *conn = pg_get_pgconn(self);
3067
3072
  VALUE rb_pgresult = Qnil;
3068
3073
  PGresult *cur, *prev;
3069
3074
 
3070
-
3071
- cur = prev = NULL;
3072
- while ((cur = gvl_PQgetResult(conn)) != NULL) {
3075
+ cur = prev = NULL;
3076
+ for(;;) {
3073
3077
  int status;
3074
3078
 
3079
+ pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3080
+
3081
+ cur = gvl_PQgetResult(conn);
3082
+ if (cur == NULL)
3083
+ break;
3084
+
3075
3085
  if (prev) PQclear(prev);
3076
3086
  prev = cur;
3077
3087
 
3078
3088
  status = PQresultStatus(cur);
3079
- if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN)
3089
+ if (status == PGRES_COPY_OUT || status == PGRES_COPY_IN || status == PGRES_COPY_BOTH)
3080
3090
  break;
3081
3091
  }
3082
3092
 
@@ -3100,22 +3110,60 @@ static VALUE
3100
3110
  pgconn_discard_results(VALUE self)
3101
3111
  {
3102
3112
  PGconn *conn = pg_get_pgconn(self);
3113
+ VALUE socket_io;
3103
3114
 
3104
- PGresult *cur;
3105
- while ((cur = gvl_PQgetResult(conn)) != NULL) {
3106
- int status = PQresultStatus(cur);
3115
+ if( PQtransactionStatus(conn) == PQTRANS_IDLE ) {
3116
+ return Qnil;
3117
+ }
3118
+
3119
+ socket_io = pgconn_socket_io(self);
3120
+
3121
+ for(;;) {
3122
+ PGresult *cur;
3123
+ int status;
3124
+
3125
+ /* pgconn_block() raises an exception in case of errors.
3126
+ * To avoid this call pg_rb_io_wait() and PQconsumeInput() without rb_raise().
3127
+ */
3128
+ while( gvl_PQisBusy(conn) ){
3129
+ pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), Qnil);
3130
+ if ( PQconsumeInput(conn) == 0 ) {
3131
+ pgconn_close_socket_io(self);
3132
+ return Qfalse;
3133
+ }
3134
+ }
3135
+
3136
+ cur = gvl_PQgetResult(conn);
3137
+ if( cur == NULL) break;
3138
+
3139
+ status = PQresultStatus(cur);
3107
3140
  PQclear(cur);
3108
3141
  if (status == PGRES_COPY_IN){
3109
3142
  gvl_PQputCopyEnd(conn, "COPY terminated by new PQexec");
3110
3143
  }
3111
3144
  if (status == PGRES_COPY_OUT){
3112
- char *buffer = NULL;
3113
- while( gvl_PQgetCopyData(conn, &buffer, 0) > 0)
3114
- PQfreemem(buffer);
3145
+ for(;;) {
3146
+ char *buffer = NULL;
3147
+ int st = gvl_PQgetCopyData(conn, &buffer, 1);
3148
+ if( st == 0 ) {
3149
+ /* would block -> wait for readable data */
3150
+ pg_rb_io_wait(socket_io, RB_INT2NUM(PG_RUBY_IO_READABLE), Qnil);
3151
+ if ( PQconsumeInput(conn) == 0 ) {
3152
+ pgconn_close_socket_io(self);
3153
+ return Qfalse;
3154
+ }
3155
+ } else if( st > 0 ) {
3156
+ /* some data retrieved -> discard it */
3157
+ PQfreemem(buffer);
3158
+ } else {
3159
+ /* no more data */
3160
+ break;
3161
+ }
3162
+ }
3115
3163
  }
3116
3164
  }
3117
3165
 
3118
- return Qnil;
3166
+ return Qtrue;
3119
3167
  }
3120
3168
 
3121
3169
  /*
@@ -3138,6 +3186,7 @@ pgconn_discard_results(VALUE self)
3138
3186
  * #exec is an alias for #async_exec which is almost identical to #sync_exec .
3139
3187
  * #sync_exec is implemented on the simpler synchronous command processing API of libpq, whereas
3140
3188
  * #async_exec is implemented on the asynchronous API and on ruby's IO mechanisms.
3189
+ * Only #async_exec is compatible to <tt>Fiber.scheduler</tt> based asynchronous IO processing introduced in ruby-3.0.
3141
3190
  * Both methods ensure that other threads can process while waiting for the server to
3142
3191
  * complete the request, but #sync_exec blocks all signals to be processed until the query is finished.
3143
3192
  * This is most notably visible by a delayed reaction to Control+C.
@@ -3152,8 +3201,7 @@ pgconn_async_exec(int argc, VALUE *argv, VALUE self)
3152
3201
 
3153
3202
  pgconn_discard_results( self );
3154
3203
  pgconn_send_query( argc, argv, self );
3155
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3156
- rb_pgresult = pgconn_get_last_result( self );
3204
+ rb_pgresult = pgconn_async_get_last_result( self );
3157
3205
 
3158
3206
  if ( rb_block_given_p() ) {
3159
3207
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3182,7 +3230,7 @@ pgconn_async_exec(int argc, VALUE *argv, VALUE self)
3182
3230
  * or, it may be a String. If it is a string, that is equivalent to the hash:
3183
3231
  * { :value => <string value>, :type => 0, :format => 0 }
3184
3232
  *
3185
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3233
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3186
3234
  * inside the SQL query. The 0th element of the +params+ array is bound
3187
3235
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
3188
3236
  *
@@ -3225,8 +3273,7 @@ pgconn_async_exec_params(int argc, VALUE *argv, VALUE self)
3225
3273
  } else {
3226
3274
  pgconn_send_query_params( argc, argv, self );
3227
3275
  }
3228
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3229
- rb_pgresult = pgconn_get_last_result( self );
3276
+ rb_pgresult = pgconn_async_get_last_result( self );
3230
3277
 
3231
3278
  if ( rb_block_given_p() ) {
3232
3279
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3252,7 +3299,7 @@ pgconn_async_exec_params(int argc, VALUE *argv, VALUE self)
3252
3299
  *
3253
3300
  * For example: "SELECT $1::int"
3254
3301
  *
3255
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3302
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3256
3303
  * inside the SQL query.
3257
3304
  *
3258
3305
  * See also corresponding {libpq function}[https://www.postgresql.org/docs/current/libpq-exec.html#LIBPQ-PQPREPARE].
@@ -3264,8 +3311,7 @@ pgconn_async_prepare(int argc, VALUE *argv, VALUE self)
3264
3311
 
3265
3312
  pgconn_discard_results( self );
3266
3313
  pgconn_send_prepare( argc, argv, self );
3267
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3268
- rb_pgresult = pgconn_get_last_result( self );
3314
+ rb_pgresult = pgconn_async_get_last_result( self );
3269
3315
 
3270
3316
  if ( rb_block_given_p() ) {
3271
3317
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3292,7 +3338,7 @@ pgconn_async_prepare(int argc, VALUE *argv, VALUE self)
3292
3338
  * or, it may be a String. If it is a string, that is equivalent to the hash:
3293
3339
  * { :value => <string value>, :format => 0 }
3294
3340
  *
3295
- * PostgreSQL bind parameters are represented as $1, $1, $2, etc.,
3341
+ * PostgreSQL bind parameters are represented as $1, $2, $3, etc.,
3296
3342
  * inside the SQL query. The 0th element of the +params+ array is bound
3297
3343
  * to $1, the 1st element is bound to $2, etc. +nil+ is treated as +NULL+.
3298
3344
  *
@@ -3318,8 +3364,7 @@ pgconn_async_exec_prepared(int argc, VALUE *argv, VALUE self)
3318
3364
 
3319
3365
  pgconn_discard_results( self );
3320
3366
  pgconn_send_query_prepared( argc, argv, self );
3321
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3322
- rb_pgresult = pgconn_get_last_result( self );
3367
+ rb_pgresult = pgconn_async_get_last_result( self );
3323
3368
 
3324
3369
  if ( rb_block_given_p() ) {
3325
3370
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3343,8 +3388,7 @@ pgconn_async_describe_portal(VALUE self, VALUE portal)
3343
3388
 
3344
3389
  pgconn_discard_results( self );
3345
3390
  pgconn_send_describe_portal( self, portal );
3346
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3347
- rb_pgresult = pgconn_get_last_result( self );
3391
+ rb_pgresult = pgconn_async_get_last_result( self );
3348
3392
 
3349
3393
  if ( rb_block_given_p() ) {
3350
3394
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3368,8 +3412,7 @@ pgconn_async_describe_prepared(VALUE self, VALUE stmt_name)
3368
3412
 
3369
3413
  pgconn_discard_results( self );
3370
3414
  pgconn_send_describe_prepared( self, stmt_name );
3371
- pgconn_block( 0, NULL, self ); /* wait for input (without blocking) before reading the last result */
3372
- rb_pgresult = pgconn_get_last_result( self );
3415
+ rb_pgresult = pgconn_async_get_last_result( self );
3373
3416
 
3374
3417
  if ( rb_block_given_p() ) {
3375
3418
  return rb_ensure( rb_yield, rb_pgresult, pg_result_clear, rb_pgresult );
@@ -3457,6 +3500,126 @@ pgconn_ssl_attribute_names(VALUE self)
3457
3500
  #endif
3458
3501
 
3459
3502
 
3503
+ #ifdef HAVE_PQENTERPIPELINEMODE
3504
+ /*
3505
+ * call-seq:
3506
+ * conn.pipeline_status -> Integer
3507
+ *
3508
+ * Returns the current pipeline mode status of the libpq connection.
3509
+ *
3510
+ * PQpipelineStatus can return one of the following values:
3511
+ *
3512
+ * * PQ_PIPELINE_ON - The libpq connection is in pipeline mode.
3513
+ * * PQ_PIPELINE_OFF - The libpq connection is not in pipeline mode.
3514
+ * * PQ_PIPELINE_ABORTED - The libpq connection is in pipeline mode and an error occurred while processing the current pipeline.
3515
+ * The aborted flag is cleared when PQgetResult returns a result of type PGRES_PIPELINE_SYNC.
3516
+ *
3517
+ * Available since PostgreSQL-14
3518
+ */
3519
+ static VALUE
3520
+ pgconn_pipeline_status(VALUE self)
3521
+ {
3522
+ int res = PQpipelineStatus(pg_get_pgconn(self));
3523
+ return INT2FIX(res);
3524
+ }
3525
+
3526
+
3527
+ /*
3528
+ * call-seq:
3529
+ * conn.enter_pipeline_mode -> nil
3530
+ *
3531
+ * Causes a connection to enter pipeline mode if it is currently idle or already in pipeline mode.
3532
+ *
3533
+ * Raises PG::Error and has no effect if the connection is not currently idle, i.e., it has a result ready, or it is waiting for more input from the server, etc.
3534
+ * This function does not actually send anything to the server, it just changes the libpq connection state.
3535
+ *
3536
+ * Available since PostgreSQL-14
3537
+ */
3538
+ static VALUE
3539
+ pgconn_enter_pipeline_mode(VALUE self)
3540
+ {
3541
+ PGconn *conn = pg_get_pgconn(self);
3542
+ int res = PQenterPipelineMode(conn);
3543
+ if( res == 1 ) {
3544
+ return Qnil;
3545
+ } else {
3546
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3547
+ }
3548
+ }
3549
+
3550
+ /*
3551
+ * call-seq:
3552
+ * conn.exit_pipeline_mode -> nil
3553
+ *
3554
+ * Causes a connection to exit pipeline mode if it is currently in pipeline mode with an empty queue and no pending results.
3555
+ *
3556
+ * Takes no action if not in pipeline mode.
3557
+ * Raises PG::Error if the current statement isn't finished processing, or PQgetResult has not been called to collect results from all previously sent query.
3558
+ *
3559
+ * Available since PostgreSQL-14
3560
+ */
3561
+ static VALUE
3562
+ pgconn_exit_pipeline_mode(VALUE self)
3563
+ {
3564
+ PGconn *conn = pg_get_pgconn(self);
3565
+ int res = PQexitPipelineMode(conn);
3566
+ if( res == 1 ) {
3567
+ return Qnil;
3568
+ } else {
3569
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3570
+ }
3571
+ }
3572
+
3573
+
3574
+ /*
3575
+ * call-seq:
3576
+ * conn.pipeline_sync -> nil
3577
+ *
3578
+ * Marks a synchronization point in a pipeline by sending a sync message and flushing the send buffer.
3579
+ * This serves as the delimiter of an implicit transaction and an error recovery point; see Section 34.5.1.3 of the PostgreSQL documentation.
3580
+ *
3581
+ * Raises PG::Error if the connection is not in pipeline mode or sending a sync message failed.
3582
+ *
3583
+ * Available since PostgreSQL-14
3584
+ */
3585
+ static VALUE
3586
+ pgconn_pipeline_sync(VALUE self)
3587
+ {
3588
+ PGconn *conn = pg_get_pgconn(self);
3589
+ int res = PQpipelineSync(conn);
3590
+ if( res == 1 ) {
3591
+ return Qnil;
3592
+ } else {
3593
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3594
+ }
3595
+ }
3596
+
3597
+ /*
3598
+ * call-seq:
3599
+ * conn.pipeline_sync -> nil
3600
+ *
3601
+ * Sends a request for the server to flush its output buffer.
3602
+ *
3603
+ * The server flushes its output buffer automatically as a result of Connection#pipeline_sync being called, or on any request when not in pipeline mode.
3604
+ * This function is useful to cause the server to flush its output buffer in pipeline mode without establishing a synchronization point.
3605
+ * Note that the request is not itself flushed to the server automatically; use Connection#flush if necessary.
3606
+ *
3607
+ * Available since PostgreSQL-14
3608
+ */
3609
+ static VALUE
3610
+ pgconn_send_flush_request(VALUE self)
3611
+ {
3612
+ PGconn *conn = pg_get_pgconn(self);
3613
+ int res = PQsendFlushRequest(conn);
3614
+ if( res == 1 ) {
3615
+ return Qnil;
3616
+ } else {
3617
+ rb_raise(rb_ePGerror, "%s", PQerrorMessage(conn));
3618
+ }
3619
+ }
3620
+
3621
+ #endif
3622
+
3460
3623
  /**************************************************************************
3461
3624
  * LARGE OBJECT SUPPORT
3462
3625
  **************************************************************************/
@@ -3801,11 +3964,11 @@ static VALUE
3801
3964
  pgconn_internal_encoding_set(VALUE self, VALUE enc)
3802
3965
  {
3803
3966
  if (NIL_P(enc)) {
3804
- pgconn_set_client_encoding( self, rb_usascii_str_new_cstr("SQL_ASCII") );
3967
+ pgconn_sync_set_client_encoding( self, rb_usascii_str_new_cstr("SQL_ASCII") );
3805
3968
  return enc;
3806
3969
  }
3807
3970
  else if ( TYPE(enc) == T_STRING && strcasecmp("JOHAB", StringValueCStr(enc)) == 0 ) {
3808
- pgconn_set_client_encoding(self, rb_usascii_str_new_cstr("JOHAB"));
3971
+ pgconn_sync_set_client_encoding(self, rb_usascii_str_new_cstr("JOHAB"));
3809
3972
  return enc;
3810
3973
  }
3811
3974
  else {
@@ -3843,16 +4006,33 @@ pgconn_external_encoding(VALUE self)
3843
4006
  return rb_enc_from_encoding( enc );
3844
4007
  }
3845
4008
 
4009
+ /*
4010
+ * call-seq:
4011
+ * conn.set_client_encoding( encoding )
4012
+ *
4013
+ * Sets the client encoding to the _encoding_ String.
4014
+ */
4015
+ static VALUE
4016
+ pgconn_async_set_client_encoding(VALUE self, VALUE encname)
4017
+ {
4018
+ VALUE query_format, query;
4019
+
4020
+ Check_Type(encname, T_STRING);
4021
+ query_format = rb_str_new_cstr("set client_encoding to '%s'");
4022
+ query = rb_funcall(query_format, rb_intern("%"), 1, encname);
4023
+
4024
+ pgconn_async_exec(1, &query, self);
4025
+ pgconn_set_internal_encoding_index( self );
4026
+
4027
+ return Qnil;
4028
+ }
3846
4029
 
3847
4030
  static VALUE
3848
4031
  pgconn_set_client_encoding_async1( VALUE args )
3849
4032
  {
3850
4033
  VALUE self = ((VALUE*)args)[0];
3851
4034
  VALUE encname = ((VALUE*)args)[1];
3852
- VALUE query_format = rb_str_new_cstr("set client_encoding to '%s'");
3853
- VALUE query = rb_funcall(query_format, rb_intern("%"), 1, encname);
3854
-
3855
- pgconn_async_exec(1, &query, self);
4035
+ pgconn_async_set_client_encoding(self, encname);
3856
4036
  return 0;
3857
4037
  }
3858
4038
 
@@ -3867,9 +4047,9 @@ pgconn_set_client_encoding_async2( VALUE arg, VALUE ex )
3867
4047
 
3868
4048
 
3869
4049
  static VALUE
3870
- pgconn_set_client_encoding_async( VALUE self, const char *encname )
4050
+ pgconn_set_client_encoding_async( VALUE self, VALUE encname )
3871
4051
  {
3872
- VALUE args[] = { self, rb_str_new_cstr(encname) };
4052
+ VALUE args[] = { self, encname };
3873
4053
  return rb_rescue(pgconn_set_client_encoding_async1, (VALUE)&args, pgconn_set_client_encoding_async2, Qnil);
3874
4054
  }
3875
4055
 
@@ -3891,10 +4071,9 @@ pgconn_set_default_encoding( VALUE self )
3891
4071
 
3892
4072
  if (( enc = rb_default_internal_encoding() )) {
3893
4073
  encname = pg_get_rb_encoding_as_pg_encoding( enc );
3894
- if ( pgconn_set_client_encoding_async(self, encname) != 0 )
4074
+ if ( pgconn_set_client_encoding_async(self, rb_str_new_cstr(encname)) != 0 )
3895
4075
  rb_warning( "Failed to set the default_internal encoding to %s: '%s'",
3896
4076
  encname, PQerrorMessage(conn) );
3897
- pgconn_set_internal_encoding_index( self );
3898
4077
  return rb_enc_from_encoding( enc );
3899
4078
  } else {
3900
4079
  pgconn_set_internal_encoding_index( self );
@@ -3916,12 +4095,12 @@ static VALUE
3916
4095
  pgconn_type_map_for_queries_set(VALUE self, VALUE typemap)
3917
4096
  {
3918
4097
  t_pg_connection *this = pg_get_connection( self );
4098
+ t_typemap *tm;
4099
+ UNUSED(tm);
4100
+
4101
+ /* Check type of method param */
4102
+ TypedData_Get_Struct(typemap, t_typemap, &pg_typemap_type, tm);
3919
4103
 
3920
- if ( !rb_obj_is_kind_of(typemap, rb_cTypeMap) ) {
3921
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
3922
- rb_obj_classname( typemap ) );
3923
- }
3924
- Check_Type(typemap, T_DATA);
3925
4104
  this->type_map_for_queries = typemap;
3926
4105
 
3927
4106
  return typemap;
@@ -3956,12 +4135,10 @@ static VALUE
3956
4135
  pgconn_type_map_for_results_set(VALUE self, VALUE typemap)
3957
4136
  {
3958
4137
  t_pg_connection *this = pg_get_connection( self );
4138
+ t_typemap *tm;
4139
+ UNUSED(tm);
3959
4140
 
3960
- if ( !rb_obj_is_kind_of(typemap, rb_cTypeMap) ) {
3961
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::TypeMap)",
3962
- rb_obj_classname( typemap ) );
3963
- }
3964
- Check_Type(typemap, T_DATA);
4141
+ TypedData_Get_Struct(typemap, t_typemap, &pg_typemap_type, tm);
3965
4142
  this->type_map_for_results = typemap;
3966
4143
 
3967
4144
  return typemap;
@@ -3996,20 +4173,19 @@ pgconn_type_map_for_results_get(VALUE self)
3996
4173
  *
3997
4174
  */
3998
4175
  static VALUE
3999
- pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE typemap)
4176
+ pgconn_encoder_for_put_copy_data_set(VALUE self, VALUE encoder)
4000
4177
  {
4001
4178
  t_pg_connection *this = pg_get_connection( self );
4002
4179
 
4003
- if( typemap != Qnil ){
4004
- if ( !rb_obj_is_kind_of(typemap, rb_cPG_Coder) ) {
4005
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::Coder)",
4006
- rb_obj_classname( typemap ) );
4007
- }
4008
- Check_Type(typemap, T_DATA);
4180
+ if( encoder != Qnil ){
4181
+ t_pg_coder *co;
4182
+ UNUSED(co);
4183
+ /* Check argument type */
4184
+ TypedData_Get_Struct(encoder, t_pg_coder, &pg_coder_type, co);
4009
4185
  }
4010
- this->encoder_for_put_copy_data = typemap;
4186
+ this->encoder_for_put_copy_data = encoder;
4011
4187
 
4012
- return typemap;
4188
+ return encoder;
4013
4189
  }
4014
4190
 
4015
4191
  /*
@@ -4045,20 +4221,19 @@ pgconn_encoder_for_put_copy_data_get(VALUE self)
4045
4221
  *
4046
4222
  */
4047
4223
  static VALUE
4048
- pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE typemap)
4224
+ pgconn_decoder_for_get_copy_data_set(VALUE self, VALUE decoder)
4049
4225
  {
4050
4226
  t_pg_connection *this = pg_get_connection( self );
4051
4227
 
4052
- if( typemap != Qnil ){
4053
- if ( !rb_obj_is_kind_of(typemap, rb_cPG_Coder) ) {
4054
- rb_raise( rb_eTypeError, "wrong argument type %s (expected kind of PG::Coder)",
4055
- rb_obj_classname( typemap ) );
4056
- }
4057
- Check_Type(typemap, T_DATA);
4228
+ if( decoder != Qnil ){
4229
+ t_pg_coder *co;
4230
+ UNUSED(co);
4231
+ /* Check argument type */
4232
+ TypedData_Get_Struct(decoder, t_pg_coder, &pg_coder_type, co);
4058
4233
  }
4059
- this->decoder_for_get_copy_data = typemap;
4234
+ this->decoder_for_get_copy_data = decoder;
4060
4235
 
4061
- return typemap;
4236
+ return decoder;
4062
4237
  }
4063
4238
 
4064
4239
  /*
@@ -4141,6 +4316,7 @@ void
4141
4316
  init_pg_connection()
4142
4317
  {
4143
4318
  s_id_encode = rb_intern("encode");
4319
+ s_id_autoclose_set = rb_intern("autoclose=");
4144
4320
  sym_type = ID2SYM(rb_intern("type"));
4145
4321
  sym_format = ID2SYM(rb_intern("format"));
4146
4322
  sym_value = ID2SYM(rb_intern("value"));
@@ -4156,10 +4332,6 @@ init_pg_connection()
4156
4332
  /****** PG::Connection CLASS METHODS ******/
4157
4333
  rb_define_alloc_func( rb_cPGconn, pgconn_s_allocate );
4158
4334
 
4159
- SINGLETON_ALIAS(rb_cPGconn, "connect", "new");
4160
- SINGLETON_ALIAS(rb_cPGconn, "open", "new");
4161
- SINGLETON_ALIAS(rb_cPGconn, "setdb", "new");
4162
- SINGLETON_ALIAS(rb_cPGconn, "setdblogin", "new");
4163
4335
  rb_define_singleton_method(rb_cPGconn, "escape_string", pgconn_s_escape, 1);
4164
4336
  SINGLETON_ALIAS(rb_cPGconn, "escape", "escape_string");
4165
4337
  rb_define_singleton_method(rb_cPGconn, "escape_bytea", pgconn_s_escape_bytea, 1);
@@ -4168,14 +4340,14 @@ init_pg_connection()
4168
4340
  rb_define_singleton_method(rb_cPGconn, "quote_ident", pgconn_s_quote_ident, 1);
4169
4341
  rb_define_singleton_method(rb_cPGconn, "connect_start", pgconn_s_connect_start, -1);
4170
4342
  rb_define_singleton_method(rb_cPGconn, "conndefaults", pgconn_s_conndefaults, 0);
4171
- rb_define_singleton_method(rb_cPGconn, "ping", pgconn_s_ping, -1);
4343
+ rb_define_singleton_method(rb_cPGconn, "sync_ping", pgconn_s_sync_ping, -1);
4344
+ rb_define_singleton_method(rb_cPGconn, "sync_connect", pgconn_s_sync_connect, -1);
4172
4345
 
4173
4346
  /****** PG::Connection INSTANCE METHODS: Connection Control ******/
4174
- rb_define_method(rb_cPGconn, "initialize", pgconn_init, -1);
4175
4347
  rb_define_method(rb_cPGconn, "connect_poll", pgconn_connect_poll, 0);
4176
4348
  rb_define_method(rb_cPGconn, "finish", pgconn_finish, 0);
4177
4349
  rb_define_method(rb_cPGconn, "finished?", pgconn_finished_p, 0);
4178
- rb_define_method(rb_cPGconn, "reset", pgconn_reset, 0);
4350
+ rb_define_method(rb_cPGconn, "sync_reset", pgconn_sync_reset, 0);
4179
4351
  rb_define_method(rb_cPGconn, "reset_start", pgconn_reset_start, 0);
4180
4352
  rb_define_method(rb_cPGconn, "reset_poll", pgconn_reset_poll, 0);
4181
4353
  rb_define_alias(rb_cPGconn, "close", "finish");
@@ -4187,9 +4359,7 @@ init_pg_connection()
4187
4359
  rb_define_method(rb_cPGconn, "host", pgconn_host, 0);
4188
4360
  rb_define_method(rb_cPGconn, "port", pgconn_port, 0);
4189
4361
  rb_define_method(rb_cPGconn, "tty", pgconn_tty, 0);
4190
- #ifdef HAVE_PQCONNINFO
4191
4362
  rb_define_method(rb_cPGconn, "conninfo", pgconn_conninfo, 0);
4192
- #endif
4193
4363
  rb_define_method(rb_cPGconn, "options", pgconn_options, 0);
4194
4364
  rb_define_method(rb_cPGconn, "status", pgconn_status, 0);
4195
4365
  rb_define_method(rb_cPGconn, "transaction_status", pgconn_transaction_status, 0);
@@ -4200,17 +4370,18 @@ init_pg_connection()
4200
4370
  rb_define_method(rb_cPGconn, "socket", pgconn_socket, 0);
4201
4371
  rb_define_method(rb_cPGconn, "socket_io", pgconn_socket_io, 0);
4202
4372
  rb_define_method(rb_cPGconn, "backend_pid", pgconn_backend_pid, 0);
4373
+ rb_define_method(rb_cPGconn, "backend_key", pgconn_backend_key, 0);
4203
4374
  rb_define_method(rb_cPGconn, "connection_needs_password", pgconn_connection_needs_password, 0);
4204
4375
  rb_define_method(rb_cPGconn, "connection_used_password", pgconn_connection_used_password, 0);
4205
4376
  /* rb_define_method(rb_cPGconn, "getssl", pgconn_getssl, 0); */
4206
4377
 
4207
4378
  /****** PG::Connection INSTANCE METHODS: Command Execution ******/
4208
- rb_define_method(rb_cPGconn, "sync_exec", pgconn_exec, -1);
4209
- rb_define_method(rb_cPGconn, "sync_exec_params", pgconn_exec_params, -1);
4210
- rb_define_method(rb_cPGconn, "sync_prepare", pgconn_prepare, -1);
4211
- rb_define_method(rb_cPGconn, "sync_exec_prepared", pgconn_exec_prepared, -1);
4212
- rb_define_method(rb_cPGconn, "sync_describe_prepared", pgconn_describe_prepared, 1);
4213
- rb_define_method(rb_cPGconn, "sync_describe_portal", pgconn_describe_portal, 1);
4379
+ rb_define_method(rb_cPGconn, "sync_exec", pgconn_sync_exec, -1);
4380
+ rb_define_method(rb_cPGconn, "sync_exec_params", pgconn_sync_exec_params, -1);
4381
+ rb_define_method(rb_cPGconn, "sync_prepare", pgconn_sync_prepare, -1);
4382
+ rb_define_method(rb_cPGconn, "sync_exec_prepared", pgconn_sync_exec_prepared, -1);
4383
+ rb_define_method(rb_cPGconn, "sync_describe_prepared", pgconn_sync_describe_prepared, 1);
4384
+ rb_define_method(rb_cPGconn, "sync_describe_portal", pgconn_sync_describe_portal, 1);
4214
4385
 
4215
4386
  rb_define_method(rb_cPGconn, "exec", pgconn_async_exec, -1);
4216
4387
  rb_define_method(rb_cPGconn, "exec_params", pgconn_async_exec_params, -1);
@@ -4243,25 +4414,26 @@ init_pg_connection()
4243
4414
  rb_define_method(rb_cPGconn, "send_query_prepared", pgconn_send_query_prepared, -1);
4244
4415
  rb_define_method(rb_cPGconn, "send_describe_prepared", pgconn_send_describe_prepared, 1);
4245
4416
  rb_define_method(rb_cPGconn, "send_describe_portal", pgconn_send_describe_portal, 1);
4246
- rb_define_method(rb_cPGconn, "get_result", pgconn_get_result, 0);
4417
+ rb_define_method(rb_cPGconn, "sync_get_result", pgconn_sync_get_result, 0);
4247
4418
  rb_define_method(rb_cPGconn, "consume_input", pgconn_consume_input, 0);
4248
4419
  rb_define_method(rb_cPGconn, "is_busy", pgconn_is_busy, 0);
4249
- rb_define_method(rb_cPGconn, "setnonblocking", pgconn_setnonblocking, 1);
4250
- rb_define_method(rb_cPGconn, "isnonblocking", pgconn_isnonblocking, 0);
4251
- rb_define_alias(rb_cPGconn, "nonblocking?", "isnonblocking");
4252
- rb_define_method(rb_cPGconn, "flush", pgconn_flush, 0);
4420
+ rb_define_method(rb_cPGconn, "sync_setnonblocking", pgconn_sync_setnonblocking, 1);
4421
+ rb_define_method(rb_cPGconn, "sync_isnonblocking", pgconn_sync_isnonblocking, 0);
4422
+ rb_define_method(rb_cPGconn, "sync_flush", pgconn_sync_flush, 0);
4423
+ rb_define_method(rb_cPGconn, "flush", pgconn_async_flush, 0);
4424
+ rb_define_alias(rb_cPGconn, "async_flush", "flush");
4253
4425
  rb_define_method(rb_cPGconn, "discard_results", pgconn_discard_results, 0);
4254
4426
 
4255
4427
  /****** PG::Connection INSTANCE METHODS: Cancelling Queries in Progress ******/
4256
- rb_define_method(rb_cPGconn, "cancel", pgconn_cancel, 0);
4428
+ rb_define_method(rb_cPGconn, "sync_cancel", pgconn_sync_cancel, 0);
4257
4429
 
4258
4430
  /****** PG::Connection INSTANCE METHODS: NOTIFY ******/
4259
4431
  rb_define_method(rb_cPGconn, "notifies", pgconn_notifies, 0);
4260
4432
 
4261
4433
  /****** PG::Connection INSTANCE METHODS: COPY ******/
4262
- rb_define_method(rb_cPGconn, "put_copy_data", pgconn_put_copy_data, -1);
4263
- rb_define_method(rb_cPGconn, "put_copy_end", pgconn_put_copy_end, -1);
4264
- rb_define_method(rb_cPGconn, "get_copy_data", pgconn_get_copy_data, -1);
4434
+ rb_define_method(rb_cPGconn, "sync_put_copy_data", pgconn_sync_put_copy_data, -1);
4435
+ rb_define_method(rb_cPGconn, "sync_put_copy_end", pgconn_sync_put_copy_end, -1);
4436
+ rb_define_method(rb_cPGconn, "sync_get_copy_data", pgconn_sync_get_copy_data, -1);
4265
4437
 
4266
4438
  /****** PG::Connection INSTANCE METHODS: Control Functions ******/
4267
4439
  rb_define_method(rb_cPGconn, "set_error_verbosity", pgconn_set_error_verbosity, 1);
@@ -4277,16 +4449,20 @@ init_pg_connection()
4277
4449
 
4278
4450
  /****** PG::Connection INSTANCE METHODS: Other ******/
4279
4451
  rb_define_method(rb_cPGconn, "get_client_encoding", pgconn_get_client_encoding, 0);
4280
- rb_define_method(rb_cPGconn, "set_client_encoding", pgconn_set_client_encoding, 1);
4452
+ rb_define_method(rb_cPGconn, "sync_set_client_encoding", pgconn_sync_set_client_encoding, 1);
4453
+ rb_define_method(rb_cPGconn, "set_client_encoding", pgconn_async_set_client_encoding, 1);
4454
+ rb_define_alias(rb_cPGconn, "async_set_client_encoding", "set_client_encoding");
4281
4455
  rb_define_alias(rb_cPGconn, "client_encoding=", "set_client_encoding");
4282
- rb_define_method(rb_cPGconn, "transaction", pgconn_transaction, 0);
4283
4456
  rb_define_method(rb_cPGconn, "block", pgconn_block, -1);
4457
+ rb_define_private_method(rb_cPGconn, "flush_data=", pgconn_flush_data_set, 1);
4284
4458
  rb_define_method(rb_cPGconn, "wait_for_notify", pgconn_wait_for_notify, -1);
4285
4459
  rb_define_alias(rb_cPGconn, "notifies_wait", "wait_for_notify");
4286
4460
  rb_define_method(rb_cPGconn, "quote_ident", pgconn_s_quote_ident, 1);
4287
- rb_define_method(rb_cPGconn, "get_last_result", pgconn_get_last_result, 0);
4461
+ rb_define_method(rb_cPGconn, "sync_get_last_result", pgconn_sync_get_last_result, 0);
4462
+ rb_define_method(rb_cPGconn, "get_last_result", pgconn_async_get_last_result, 0);
4463
+ rb_define_alias(rb_cPGconn, "async_get_last_result", "get_last_result");
4288
4464
  #ifdef HAVE_PQENCRYPTPASSWORDCONN
4289
- rb_define_method(rb_cPGconn, "encrypt_password", pgconn_encrypt_password, -1);
4465
+ rb_define_method(rb_cPGconn, "sync_encrypt_password", pgconn_sync_encrypt_password, -1);
4290
4466
  #endif
4291
4467
 
4292
4468
  #ifdef HAVE_PQSSLATTRIBUTE
@@ -4295,6 +4471,14 @@ init_pg_connection()
4295
4471
  rb_define_method(rb_cPGconn, "ssl_attribute_names", pgconn_ssl_attribute_names, 0);
4296
4472
  #endif
4297
4473
 
4474
+ #ifdef HAVE_PQENTERPIPELINEMODE
4475
+ rb_define_method(rb_cPGconn, "pipeline_status", pgconn_pipeline_status, 0);
4476
+ rb_define_method(rb_cPGconn, "enter_pipeline_mode", pgconn_enter_pipeline_mode, 0);
4477
+ rb_define_method(rb_cPGconn, "exit_pipeline_mode", pgconn_exit_pipeline_mode, 0);
4478
+ rb_define_method(rb_cPGconn, "pipeline_sync", pgconn_pipeline_sync, 0);
4479
+ rb_define_method(rb_cPGconn, "send_flush_request", pgconn_send_flush_request, 0);
4480
+ #endif
4481
+
4298
4482
  /****** PG::Connection INSTANCE METHODS: Large Object Support ******/
4299
4483
  rb_define_method(rb_cPGconn, "lo_creat", pgconn_locreat, -1);
4300
4484
  rb_define_alias(rb_cPGconn, "locreat", "lo_creat");