mysql5.1のC言語用関数mysql_ping()が再接続してくれない

mysql_ping()という関数が、MySQLのC言語用APIに用意されています。
マニュアルによると、接続が切れていたら再接続を試みると書いてある。

http://dev.mysql.com/doc/refman/5.1/ja/mysql-ping.html

ところが試してみると、

MySQL server has gone away  

と言われてしまいます。おかしいなと思って英語版のほうのマニュアルを見たら、auto-reconnectをenableにしたときは再接続すると書いてある。で、デフォルトではdisableになっているのでした。

http://dev.mysql.com/doc/refman/5.1/en/mysql-ping.html

やっぱりちゃんと英語版のほうを読まないと危ないですね。