You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

1088 lines
20 KiB

  1. '\" t
  2. .\" Title: \fBmysqladmin\fR
  3. .\" Author: [FIXME: author] [see http://docbook.sf.net/el/author]
  4. .\" Generator: DocBook XSL Stylesheets v1.75.2 <http://docbook.sf.net/>
  5. .\" Date: 04/06/2010
  6. .\" Manual: MySQL Database System
  7. .\" Source: MySQL 5.1
  8. .\" Language: English
  9. .\"
  10. .TH "\FBMYSQLADMIN\FR" "1" "04/06/2010" "MySQL 5\&.1" "MySQL Database System"
  11. .\" -----------------------------------------------------------------
  12. .\" * set default formatting
  13. .\" -----------------------------------------------------------------
  14. .\" disable hyphenation
  15. .nh
  16. .\" disable justification (adjust text to left margin only)
  17. .ad l
  18. .\" -----------------------------------------------------------------
  19. .\" * MAIN CONTENT STARTS HERE *
  20. .\" -----------------------------------------------------------------
  21. .\" mysqladmin
  22. .\" administration: server
  23. .\" server administration
  24. .SH "NAME"
  25. mysqladmin \- client for administering a MySQL server
  26. .SH "SYNOPSIS"
  27. .HP \w'\fBmysqladmin\ [\fR\fB\fIoptions\fR\fR\fB]\ \fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-options\fR\fR\fB]\ [\fR\fB\fIcommand\fR\fR\fB\ [\fR\fB\fIcommand\-options\fR\fR\fB]]\ \&.\&.\&.\fR\ 'u
  28. \fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-options\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-options\fR\fR\fB]] \&.\&.\&.\fR
  29. .SH "DESCRIPTION"
  30. .PP
  31. \fBmysqladmin\fR
  32. is a client for performing administrative operations\&. You can use it to check the server\'s configuration and current status, to create and drop databases, and more\&.
  33. .PP
  34. Invoke
  35. \fBmysqladmin\fR
  36. like this:
  37. .sp
  38. .if n \{\
  39. .RS 4
  40. .\}
  41. .nf
  42. shell> \fBmysqladmin [\fR\fB\fIoptions\fR\fR\fB] \fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB] [\fR\fB\fIcommand\fR\fR\fB [\fR\fB\fIcommand\-arg\fR\fR\fB]] \&.\&.\&.\fR
  43. .fi
  44. .if n \{\
  45. .RE
  46. .\}
  47. .PP
  48. \fBmysqladmin\fR
  49. supports the following commands\&. Some of the commands take an argument following the command name\&.
  50. .sp
  51. .RS 4
  52. .ie n \{\
  53. \h'-04'\(bu\h'+03'\c
  54. .\}
  55. .el \{\
  56. .sp -1
  57. .IP \(bu 2.3
  58. .\}
  59. create \fIdb_name\fR
  60. .sp
  61. Create a new database named
  62. \fIdb_name\fR\&.
  63. .RE
  64. .sp
  65. .RS 4
  66. .ie n \{\
  67. \h'-04'\(bu\h'+03'\c
  68. .\}
  69. .el \{\
  70. .sp -1
  71. .IP \(bu 2.3
  72. .\}
  73. debug
  74. .sp
  75. Tell the server to write debug information to the error log\&.
  76. .sp
  77. Beginning with MySQL 5\&.1\&.12, this includes information about the Event Scheduler\&. See
  78. Section\ \&19.4.5, \(lqEvent Scheduler Status\(rq\&.
  79. .RE
  80. .sp
  81. .RS 4
  82. .ie n \{\
  83. \h'-04'\(bu\h'+03'\c
  84. .\}
  85. .el \{\
  86. .sp -1
  87. .IP \(bu 2.3
  88. .\}
  89. drop \fIdb_name\fR
  90. .sp
  91. Delete the database named
  92. \fIdb_name\fR
  93. and all its tables\&.
  94. .RE
  95. .sp
  96. .RS 4
  97. .ie n \{\
  98. \h'-04'\(bu\h'+03'\c
  99. .\}
  100. .el \{\
  101. .sp -1
  102. .IP \(bu 2.3
  103. .\}
  104. extended\-status
  105. .sp
  106. Display the server status variables and their values\&.
  107. .RE
  108. .sp
  109. .RS 4
  110. .ie n \{\
  111. \h'-04'\(bu\h'+03'\c
  112. .\}
  113. .el \{\
  114. .sp -1
  115. .IP \(bu 2.3
  116. .\}
  117. flush\-hosts
  118. .sp
  119. Flush all information in the host cache\&.
  120. .RE
  121. .sp
  122. .RS 4
  123. .ie n \{\
  124. \h'-04'\(bu\h'+03'\c
  125. .\}
  126. .el \{\
  127. .sp -1
  128. .IP \(bu 2.3
  129. .\}
  130. flush\-logs
  131. .sp
  132. Flush all logs\&.
  133. .RE
  134. .sp
  135. .RS 4
  136. .ie n \{\
  137. \h'-04'\(bu\h'+03'\c
  138. .\}
  139. .el \{\
  140. .sp -1
  141. .IP \(bu 2.3
  142. .\}
  143. flush\-privileges
  144. .sp
  145. Reload the grant tables (same as
  146. reload)\&.
  147. .RE
  148. .sp
  149. .RS 4
  150. .ie n \{\
  151. \h'-04'\(bu\h'+03'\c
  152. .\}
  153. .el \{\
  154. .sp -1
  155. .IP \(bu 2.3
  156. .\}
  157. flush\-status
  158. .sp
  159. Clear status variables\&.
  160. .RE
  161. .sp
  162. .RS 4
  163. .ie n \{\
  164. \h'-04'\(bu\h'+03'\c
  165. .\}
  166. .el \{\
  167. .sp -1
  168. .IP \(bu 2.3
  169. .\}
  170. flush\-tables
  171. .sp
  172. Flush all tables\&.
  173. .RE
  174. .sp
  175. .RS 4
  176. .ie n \{\
  177. \h'-04'\(bu\h'+03'\c
  178. .\}
  179. .el \{\
  180. .sp -1
  181. .IP \(bu 2.3
  182. .\}
  183. flush\-threads
  184. .sp
  185. Flush the thread cache\&.
  186. .RE
  187. .sp
  188. .RS 4
  189. .ie n \{\
  190. \h'-04'\(bu\h'+03'\c
  191. .\}
  192. .el \{\
  193. .sp -1
  194. .IP \(bu 2.3
  195. .\}
  196. kill \fIid\fR,\fIid\fR,\&.\&.\&.
  197. .sp
  198. Kill server threads\&. If multiple thread ID values are given, there must be no spaces in the list\&.
  199. .RE
  200. .sp
  201. .RS 4
  202. .ie n \{\
  203. \h'-04'\(bu\h'+03'\c
  204. .\}
  205. .el \{\
  206. .sp -1
  207. .IP \(bu 2.3
  208. .\}
  209. old\-password \fInew\-password\fR
  210. .sp
  211. This is like the
  212. password
  213. command but stores the password using the old (pre\-4\&.1) password\-hashing format\&. (See
  214. Section\ \&5.3.2.3, \(lqPassword Hashing in MySQL\(rq\&.)
  215. .RE
  216. .sp
  217. .RS 4
  218. .ie n \{\
  219. \h'-04'\(bu\h'+03'\c
  220. .\}
  221. .el \{\
  222. .sp -1
  223. .IP \(bu 2.3
  224. .\}
  225. password \fInew\-password\fR
  226. .sp
  227. Set a new password\&. This changes the password to
  228. \fInew\-password\fR
  229. for the account that you use with
  230. \fBmysqladmin\fR
  231. for connecting to the server\&. Thus, the next time you invoke
  232. \fBmysqladmin\fR
  233. (or any other client program) using the same account, you will need to specify the new password\&.
  234. .sp
  235. If the
  236. \fInew\-password\fR
  237. value contains spaces or other characters that are special to your command interpreter, you need to enclose it within quotes\&. On Windows, be sure to use double quotes rather than single quotes; single quotes are not stripped from the password, but rather are interpreted as part of the password\&. For example:
  238. .sp
  239. .if n \{\
  240. .RS 4
  241. .\}
  242. .nf
  243. shell> \fBmysqladmin password "my new password"\fR
  244. .fi
  245. .if n \{\
  246. .RE
  247. .\}
  248. .if n \{\
  249. .sp
  250. .\}
  251. .RS 4
  252. .it 1 an-trap
  253. .nr an-no-space-flag 1
  254. .nr an-break-flag 1
  255. .br
  256. .ps +1
  257. \fBCaution\fR
  258. .ps -1
  259. .br
  260. Do not use this command used if the server was started with the
  261. \fB\-\-skip\-grant\-tables\fR
  262. option\&. No password change will be applied\&. This is true even if you precede the
  263. password
  264. command with
  265. flush\-privileges
  266. on the same command line to re\-enable the grant tables because the flush operation occurs after you connect\&. However, you can use
  267. \fBmysqladmin flush\-privileges\fR
  268. to re\-enable the grant table and then use a separate
  269. \fBmysqladmin password\fR
  270. command to change the password\&.
  271. .sp .5v
  272. .RE
  273. .RE
  274. .sp
  275. .RS 4
  276. .ie n \{\
  277. \h'-04'\(bu\h'+03'\c
  278. .\}
  279. .el \{\
  280. .sp -1
  281. .IP \(bu 2.3
  282. .\}
  283. ping
  284. .sp
  285. Check whether the server is alive\&. The return status from
  286. \fBmysqladmin\fR
  287. is 0 if the server is running, 1 if it is not\&. This is 0 even in case of an error such as
  288. Access denied, because this means that the server is running but refused the connection, which is different from the server not running\&.
  289. .RE
  290. .sp
  291. .RS 4
  292. .ie n \{\
  293. \h'-04'\(bu\h'+03'\c
  294. .\}
  295. .el \{\
  296. .sp -1
  297. .IP \(bu 2.3
  298. .\}
  299. processlist
  300. .sp
  301. Show a list of active server threads\&. This is like the output of the
  302. SHOW PROCESSLIST
  303. statement\&. If the
  304. \fB\-\-verbose\fR
  305. option is given, the output is like that of
  306. SHOW FULL PROCESSLIST\&. (See
  307. Section\ \&12.4.5.31, \(lqSHOW PROCESSLIST Syntax\(rq\&.)
  308. .RE
  309. .sp
  310. .RS 4
  311. .ie n \{\
  312. \h'-04'\(bu\h'+03'\c
  313. .\}
  314. .el \{\
  315. .sp -1
  316. .IP \(bu 2.3
  317. .\}
  318. reload
  319. .sp
  320. Reload the grant tables\&.
  321. .RE
  322. .sp
  323. .RS 4
  324. .ie n \{\
  325. \h'-04'\(bu\h'+03'\c
  326. .\}
  327. .el \{\
  328. .sp -1
  329. .IP \(bu 2.3
  330. .\}
  331. refresh
  332. .sp
  333. Flush all tables and close and open log files\&.
  334. .RE
  335. .sp
  336. .RS 4
  337. .ie n \{\
  338. \h'-04'\(bu\h'+03'\c
  339. .\}
  340. .el \{\
  341. .sp -1
  342. .IP \(bu 2.3
  343. .\}
  344. shutdown
  345. .sp
  346. Stop the server\&.
  347. .RE
  348. .sp
  349. .RS 4
  350. .ie n \{\
  351. \h'-04'\(bu\h'+03'\c
  352. .\}
  353. .el \{\
  354. .sp -1
  355. .IP \(bu 2.3
  356. .\}
  357. start\-slave
  358. .sp
  359. Start replication on a slave server\&.
  360. .RE
  361. .sp
  362. .RS 4
  363. .ie n \{\
  364. \h'-04'\(bu\h'+03'\c
  365. .\}
  366. .el \{\
  367. .sp -1
  368. .IP \(bu 2.3
  369. .\}
  370. status
  371. .sp
  372. Display a short server status message\&.
  373. .RE
  374. .sp
  375. .RS 4
  376. .ie n \{\
  377. \h'-04'\(bu\h'+03'\c
  378. .\}
  379. .el \{\
  380. .sp -1
  381. .IP \(bu 2.3
  382. .\}
  383. stop\-slave
  384. .sp
  385. Stop replication on a slave server\&.
  386. .RE
  387. .sp
  388. .RS 4
  389. .ie n \{\
  390. \h'-04'\(bu\h'+03'\c
  391. .\}
  392. .el \{\
  393. .sp -1
  394. .IP \(bu 2.3
  395. .\}
  396. variables
  397. .sp
  398. Display the server system variables and their values\&.
  399. .RE
  400. .sp
  401. .RS 4
  402. .ie n \{\
  403. \h'-04'\(bu\h'+03'\c
  404. .\}
  405. .el \{\
  406. .sp -1
  407. .IP \(bu 2.3
  408. .\}
  409. version
  410. .sp
  411. Display version information from the server\&.
  412. .RE
  413. .PP
  414. All commands can be shortened to any unique prefix\&. For example:
  415. .sp
  416. .if n \{\
  417. .RS 4
  418. .\}
  419. .nf
  420. shell> \fBmysqladmin proc stat\fR
  421. +\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  422. | Id | User | Host | db | Command | Time | State | Info |
  423. +\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  424. | 51 | monty | localhost | | Query | 0 | | show processlist |
  425. +\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-+\-\-\-\-+\-\-\-\-\-\-\-\-\-+\-\-\-\-\-\-+\-\-\-\-\-\-\-+\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-\-+
  426. Uptime: 1473624 Threads: 1 Questions: 39487
  427. Slow queries: 0 Opens: 541 Flush tables: 1
  428. Open tables: 19 Queries per second avg: 0\&.0268
  429. .fi
  430. .if n \{\
  431. .RE
  432. .\}
  433. .sp
  434. .\" status command: results
  435. .PP
  436. The
  437. \fBmysqladmin status\fR
  438. command result displays the following values:
  439. .sp
  440. .RS 4
  441. .ie n \{\
  442. \h'-04'\(bu\h'+03'\c
  443. .\}
  444. .el \{\
  445. .sp -1
  446. .IP \(bu 2.3
  447. .\}
  448. .\" uptime
  449. Uptime
  450. .sp
  451. The number of seconds the MySQL server has been running\&.
  452. .RE
  453. .sp
  454. .RS 4
  455. .ie n \{\
  456. \h'-04'\(bu\h'+03'\c
  457. .\}
  458. .el \{\
  459. .sp -1
  460. .IP \(bu 2.3
  461. .\}
  462. .\" threads
  463. Threads
  464. .sp
  465. The number of active threads (clients)\&.
  466. .RE
  467. .sp
  468. .RS 4
  469. .ie n \{\
  470. \h'-04'\(bu\h'+03'\c
  471. .\}
  472. .el \{\
  473. .sp -1
  474. .IP \(bu 2.3
  475. .\}
  476. .\" questions
  477. Questions
  478. .sp
  479. The number of questions (queries) from clients since the server was started\&.
  480. .RE
  481. .sp
  482. .RS 4
  483. .ie n \{\
  484. \h'-04'\(bu\h'+03'\c
  485. .\}
  486. .el \{\
  487. .sp -1
  488. .IP \(bu 2.3
  489. .\}
  490. .\" slow queries
  491. Slow queries
  492. .sp
  493. The number of queries that have taken more than
  494. long_query_time
  495. seconds\&. See
  496. Section\ \&5.2.5, \(lqThe Slow Query Log\(rq\&.
  497. .RE
  498. .sp
  499. .RS 4
  500. .ie n \{\
  501. \h'-04'\(bu\h'+03'\c
  502. .\}
  503. .el \{\
  504. .sp -1
  505. .IP \(bu 2.3
  506. .\}
  507. .\" opens
  508. Opens
  509. .sp
  510. The number of tables the server has opened\&.
  511. .RE
  512. .sp
  513. .RS 4
  514. .ie n \{\
  515. \h'-04'\(bu\h'+03'\c
  516. .\}
  517. .el \{\
  518. .sp -1
  519. .IP \(bu 2.3
  520. .\}
  521. .\" flush tables
  522. .\" tables: flush
  523. Flush tables
  524. .sp
  525. The number of
  526. flush\-*,
  527. refresh, and
  528. reload
  529. commands the server has executed\&.
  530. .RE
  531. .sp
  532. .RS 4
  533. .ie n \{\
  534. \h'-04'\(bu\h'+03'\c
  535. .\}
  536. .el \{\
  537. .sp -1
  538. .IP \(bu 2.3
  539. .\}
  540. .\" open tables
  541. Open tables
  542. .sp
  543. The number of tables that currently are open\&.
  544. .RE
  545. .sp
  546. .RS 4
  547. .ie n \{\
  548. \h'-04'\(bu\h'+03'\c
  549. .\}
  550. .el \{\
  551. .sp -1
  552. .IP \(bu 2.3
  553. .\}
  554. .\" memory use
  555. Memory in use
  556. .sp
  557. The amount of memory allocated directly by
  558. \fBmysqld\fR\&. This value is displayed only when MySQL has been compiled with
  559. \fB\-\-with\-debug=full\fR\&.
  560. .RE
  561. .sp
  562. .RS 4
  563. .ie n \{\
  564. \h'-04'\(bu\h'+03'\c
  565. .\}
  566. .el \{\
  567. .sp -1
  568. .IP \(bu 2.3
  569. .\}
  570. .\" maximum memory used
  571. Maximum memory used
  572. .sp
  573. The maximum amount of memory allocated directly by
  574. \fBmysqld\fR\&. This value is displayed only when MySQL has been compiled with
  575. \fB\-\-with\-debug=full\fR\&.
  576. .RE
  577. .PP
  578. If you execute
  579. \fBmysqladmin shutdown\fR
  580. when connecting to a local server using a Unix socket file,
  581. \fBmysqladmin\fR
  582. waits until the server\'s process ID file has been removed, to ensure that the server has stopped properly\&.
  583. .\" mysqladmin command options
  584. .\" command options: mysqladmin
  585. .\" options: command-line: mysqladmin
  586. .\" startup parameters: mysqladmin
  587. .PP
  588. \fBmysqladmin\fR
  589. supports the following options, which can be specified on the command line or in the
  590. [mysqladmin]
  591. and
  592. [client]
  593. option file groups\&.
  594. \fBmysqladmin\fR
  595. also supports the options for processing option files described at
  596. Section\ \&4.2.3.3.1, \(lqCommand-Line Options that Affect Option-File Handling\(rq\&.
  597. .sp
  598. .RS 4
  599. .ie n \{\
  600. \h'-04'\(bu\h'+03'\c
  601. .\}
  602. .el \{\
  603. .sp -1
  604. .IP \(bu 2.3
  605. .\}
  606. .\" mysqladmin: help option
  607. .\" help option: mysqladmin
  608. \fB\-\-help\fR,
  609. \fB\-?\fR
  610. .sp
  611. Display a help message and exit\&.
  612. .RE
  613. .sp
  614. .RS 4
  615. .ie n \{\
  616. \h'-04'\(bu\h'+03'\c
  617. .\}
  618. .el \{\
  619. .sp -1
  620. .IP \(bu 2.3
  621. .\}
  622. .\" mysqladmin: character-sets-dir option
  623. .\" character-sets-dir option: mysqladmin
  624. \fB\-\-character\-sets\-dir=\fR\fB\fIpath\fR\fR
  625. .sp
  626. The directory where character sets are installed\&. See
  627. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
  628. .RE
  629. .sp
  630. .RS 4
  631. .ie n \{\
  632. \h'-04'\(bu\h'+03'\c
  633. .\}
  634. .el \{\
  635. .sp -1
  636. .IP \(bu 2.3
  637. .\}
  638. .\" mysqladmin: compress option
  639. .\" compress option: mysqladmin
  640. \fB\-\-compress\fR,
  641. \fB\-C\fR
  642. .sp
  643. Compress all information sent between the client and the server if both support compression\&.
  644. .RE
  645. .sp
  646. .RS 4
  647. .ie n \{\
  648. \h'-04'\(bu\h'+03'\c
  649. .\}
  650. .el \{\
  651. .sp -1
  652. .IP \(bu 2.3
  653. .\}
  654. .\" mysqladmin: count option
  655. .\" count option: mysqladmin
  656. \fB\-\-count=\fR\fB\fIN\fR\fR,
  657. \fB\-c \fR\fB\fIN\fR\fR
  658. .sp
  659. The number of iterations to make for repeated command execution if the
  660. \fB\-\-sleep\fR
  661. option is given\&.
  662. .RE
  663. .sp
  664. .RS 4
  665. .ie n \{\
  666. \h'-04'\(bu\h'+03'\c
  667. .\}
  668. .el \{\
  669. .sp -1
  670. .IP \(bu 2.3
  671. .\}
  672. .\" mysqladmin: debug option
  673. .\" debug option: mysqladmin
  674. \fB\-\-debug[=\fR\fB\fIdebug_options\fR\fR\fB]\fR,
  675. \fB\-# [\fR\fB\fIdebug_options\fR\fR\fB]\fR
  676. .sp
  677. Write a debugging log\&. A typical
  678. \fIdebug_options\fR
  679. string is
  680. \'d:t:o,\fIfile_name\fR\'\&. The default is
  681. \'d:t:o,/tmp/mysqladmin\&.trace\'\&.
  682. .RE
  683. .sp
  684. .RS 4
  685. .ie n \{\
  686. \h'-04'\(bu\h'+03'\c
  687. .\}
  688. .el \{\
  689. .sp -1
  690. .IP \(bu 2.3
  691. .\}
  692. .\" mysqladmin: debug-check option
  693. .\" debug-check option: mysqladmin
  694. \fB\-\-debug\-check\fR
  695. .sp
  696. Print some debugging information when the program exits\&. This option was added in MySQL 5\&.1\&.21\&.
  697. .RE
  698. .sp
  699. .RS 4
  700. .ie n \{\
  701. \h'-04'\(bu\h'+03'\c
  702. .\}
  703. .el \{\
  704. .sp -1
  705. .IP \(bu 2.3
  706. .\}
  707. .\" mysqladmin: debug-info option
  708. .\" debug-info option: mysqladmin
  709. \fB\-\-debug\-info\fR
  710. .sp
  711. Print debugging information and memory and CPU usage statistics when the program exits\&. This option was added in MySQL 5\&.1\&.14\&.
  712. .RE
  713. .sp
  714. .RS 4
  715. .ie n \{\
  716. \h'-04'\(bu\h'+03'\c
  717. .\}
  718. .el \{\
  719. .sp -1
  720. .IP \(bu 2.3
  721. .\}
  722. .\" mysqladmin: default-character-set option
  723. .\" default-character-set option: mysqladmin
  724. \fB\-\-default\-character\-set=\fR\fB\fIcharset_name\fR\fR
  725. .sp
  726. Use
  727. \fIcharset_name\fR
  728. as the default character set\&. See
  729. Section\ \&9.5, \(lqCharacter Set Configuration\(rq\&.
  730. .RE
  731. .sp
  732. .RS 4
  733. .ie n \{\
  734. \h'-04'\(bu\h'+03'\c
  735. .\}
  736. .el \{\
  737. .sp -1
  738. .IP \(bu 2.3
  739. .\}
  740. .\" mysqladmin: force option
  741. .\" force option: mysqladmin
  742. \fB\-\-force\fR,
  743. \fB\-f\fR
  744. .sp
  745. Do not ask for confirmation for the
  746. drop \fIdb_name\fR
  747. command\&. With multiple commands, continue even if an error occurs\&.
  748. .RE
  749. .sp
  750. .RS 4
  751. .ie n \{\
  752. \h'-04'\(bu\h'+03'\c
  753. .\}
  754. .el \{\
  755. .sp -1
  756. .IP \(bu 2.3
  757. .\}
  758. .\" mysqladmin: host option
  759. .\" host option: mysqladmin
  760. \fB\-\-host=\fR\fB\fIhost_name\fR\fR,
  761. \fB\-h \fR\fB\fIhost_name\fR\fR
  762. .sp
  763. Connect to the MySQL server on the given host\&.
  764. .RE
  765. .sp
  766. .RS 4
  767. .ie n \{\
  768. \h'-04'\(bu\h'+03'\c
  769. .\}
  770. .el \{\
  771. .sp -1
  772. .IP \(bu 2.3
  773. .\}
  774. .\" mysqladmin: no-beep option
  775. .\" no-beep option: mysqladmin
  776. \fB\-\-no\-beep\fR,
  777. \fB\-b\fR
  778. .sp
  779. Suppress the warning beep that is emitted by default for errors such as a failure to connect to the server\&. This option was added in MySQL 5\&.1\&.17\&.
  780. .RE
  781. .sp
  782. .RS 4
  783. .ie n \{\
  784. \h'-04'\(bu\h'+03'\c
  785. .\}
  786. .el \{\
  787. .sp -1
  788. .IP \(bu 2.3
  789. .\}
  790. .\" mysqladmin: password option
  791. .\" password option: mysqladmin
  792. \fB\-\-password[=\fR\fB\fIpassword\fR\fR\fB]\fR,
  793. \fB\-p[\fR\fB\fIpassword\fR\fR\fB]\fR
  794. .sp
  795. The password to use when connecting to the server\&. If you use the short option form (\fB\-p\fR), you
  796. \fIcannot\fR
  797. have a space between the option and the password\&. If you omit the
  798. \fIpassword\fR
  799. value following the
  800. \fB\-\-password\fR
  801. or
  802. \fB\-p\fR
  803. option on the command line,
  804. \fBmysqladmin\fR
  805. prompts for one\&.
  806. .sp
  807. Specifying a password on the command line should be considered insecure\&. See
  808. Section\ \&5.3.2.2, \(lqEnd-User Guidelines for Password Security\(rq\&. You can use an option file to avoid giving the password on the command line\&.
  809. .RE
  810. .sp
  811. .RS 4
  812. .ie n \{\
  813. \h'-04'\(bu\h'+03'\c
  814. .\}
  815. .el \{\
  816. .sp -1
  817. .IP \(bu 2.3
  818. .\}
  819. .\" mysqladmin: pipe option
  820. .\" pipe option: mysqladmin
  821. \fB\-\-pipe\fR,
  822. \fB\-W\fR
  823. .sp
  824. On Windows, connect to the server via a named pipe\&. This option applies only if the server supports named\-pipe connections\&.
  825. .RE
  826. .sp
  827. .RS 4
  828. .ie n \{\
  829. \h'-04'\(bu\h'+03'\c
  830. .\}
  831. .el \{\
  832. .sp -1
  833. .IP \(bu 2.3
  834. .\}
  835. .\" mysqladmin: port option
  836. .\" port option: mysqladmin
  837. \fB\-\-port=\fR\fB\fIport_num\fR\fR,
  838. \fB\-P \fR\fB\fIport_num\fR\fR
  839. .sp
  840. The TCP/IP port number to use for the connection\&.
  841. .RE
  842. .sp
  843. .RS 4
  844. .ie n \{\
  845. \h'-04'\(bu\h'+03'\c
  846. .\}
  847. .el \{\
  848. .sp -1
  849. .IP \(bu 2.3
  850. .\}
  851. .\" mysqladmin: protocol option
  852. .\" protocol option: mysqladmin
  853. \fB\-\-protocol={TCP|SOCKET|PIPE|MEMORY}\fR
  854. .sp
  855. The connection protocol to use for connecting to the server\&. It is useful when the other connection parameters normally would cause a protocol to be used other than the one you want\&. For details on the allowable values, see
  856. Section\ \&4.2.2, \(lqConnecting to the MySQL Server\(rq\&.
  857. .RE
  858. .sp
  859. .RS 4
  860. .ie n \{\
  861. \h'-04'\(bu\h'+03'\c
  862. .\}
  863. .el \{\
  864. .sp -1
  865. .IP \(bu 2.3
  866. .\}
  867. .\" mysqladmin: relative option
  868. .\" relative option: mysqladmin
  869. \fB\-\-relative\fR,
  870. \fB\-r\fR
  871. .sp
  872. Show the difference between the current and previous values when used with the
  873. \fB\-\-sleep\fR
  874. option\&. Currently, this option works only with the
  875. extended\-status
  876. command\&.
  877. .RE
  878. .sp
  879. .RS 4
  880. .ie n \{\
  881. \h'-04'\(bu\h'+03'\c
  882. .\}
  883. .el \{\
  884. .sp -1
  885. .IP \(bu 2.3
  886. .\}
  887. .\" mysqladmin: silent option
  888. .\" silent option: mysqladmin
  889. \fB\-\-silent\fR,
  890. \fB\-s\fR
  891. .sp
  892. Exit silently if a connection to the server cannot be established\&.
  893. .RE
  894. .sp
  895. .RS 4
  896. .ie n \{\
  897. \h'-04'\(bu\h'+03'\c
  898. .\}
  899. .el \{\
  900. .sp -1
  901. .IP \(bu 2.3
  902. .\}
  903. .\" mysqladmin: sleep option
  904. .\" sleep option: mysqladmin
  905. \fB\-\-sleep=\fR\fB\fIdelay\fR\fR,
  906. \fB\-i \fR\fB\fIdelay\fR\fR
  907. .sp
  908. Execute commands repeatedly, sleeping for
  909. \fIdelay\fR
  910. seconds in between\&. The
  911. \fB\-\-count\fR
  912. option determines the number of iterations\&. If
  913. \fB\-\-count\fR
  914. is not given,
  915. \fBmysqladmin\fR
  916. executes commands indefinitely until interrupted\&.
  917. .RE
  918. .sp
  919. .RS 4
  920. .ie n \{\
  921. \h'-04'\(bu\h'+03'\c
  922. .\}
  923. .el \{\
  924. .sp -1
  925. .IP \(bu 2.3
  926. .\}
  927. .\" mysqladmin: socket option
  928. .\" socket option: mysqladmin
  929. \fB\-\-socket=\fR\fB\fIpath\fR\fR,
  930. \fB\-S \fR\fB\fIpath\fR\fR
  931. .sp
  932. For connections to
  933. localhost, the Unix socket file to use, or, on Windows, the name of the named pipe to use\&.
  934. .RE
  935. .sp
  936. .RS 4
  937. .ie n \{\
  938. \h'-04'\(bu\h'+03'\c
  939. .\}
  940. .el \{\
  941. .sp -1
  942. .IP \(bu 2.3
  943. .\}
  944. .\" mysqladmin: SSL options
  945. .\" SSL options: mysqladmin
  946. \fB\-\-ssl*\fR
  947. .sp
  948. Options that begin with
  949. \fB\-\-ssl\fR
  950. specify whether to connect to the server via SSL and indicate where to find SSL keys and certificates\&. See
  951. Section\ \&5.5.6.3, \(lqSSL Command Options\(rq\&.
  952. .RE
  953. .sp
  954. .RS 4
  955. .ie n \{\
  956. \h'-04'\(bu\h'+03'\c
  957. .\}
  958. .el \{\
  959. .sp -1
  960. .IP \(bu 2.3
  961. .\}
  962. .\" mysqladmin: user option
  963. .\" user option: mysqladmin
  964. \fB\-\-user=\fR\fB\fIuser_name\fR\fR,
  965. \fB\-u \fR\fB\fIuser_name\fR\fR
  966. .sp
  967. The MySQL user name to use when connecting to the server\&.
  968. .RE
  969. .sp
  970. .RS 4
  971. .ie n \{\
  972. \h'-04'\(bu\h'+03'\c
  973. .\}
  974. .el \{\
  975. .sp -1
  976. .IP \(bu 2.3
  977. .\}
  978. .\" mysqladmin: verbose option
  979. .\" verbose option: mysqladmin
  980. \fB\-\-verbose\fR,
  981. \fB\-v\fR
  982. .sp
  983. Verbose mode\&. Print more information about what the program does\&.
  984. .RE
  985. .sp
  986. .RS 4
  987. .ie n \{\
  988. \h'-04'\(bu\h'+03'\c
  989. .\}
  990. .el \{\
  991. .sp -1
  992. .IP \(bu 2.3
  993. .\}
  994. .\" mysqladmin: version option
  995. .\" version option: mysqladmin
  996. \fB\-\-version\fR,
  997. \fB\-V\fR
  998. .sp
  999. Display version information and exit\&.
  1000. .RE
  1001. .sp
  1002. .RS 4
  1003. .ie n \{\
  1004. \h'-04'\(bu\h'+03'\c
  1005. .\}
  1006. .el \{\
  1007. .sp -1
  1008. .IP \(bu 2.3
  1009. .\}
  1010. .\" mysqladmin: vertical option
  1011. .\" vertical option: mysqladmin
  1012. \fB\-\-vertical\fR,
  1013. \fB\-E\fR
  1014. .sp
  1015. Print output vertically\&. This is similar to
  1016. \fB\-\-relative\fR, but prints output vertically\&.
  1017. .RE
  1018. .sp
  1019. .RS 4
  1020. .ie n \{\
  1021. \h'-04'\(bu\h'+03'\c
  1022. .\}
  1023. .el \{\
  1024. .sp -1
  1025. .IP \(bu 2.3
  1026. .\}
  1027. .\" mysqladmin: wait option
  1028. .\" wait option: mysqladmin
  1029. \fB\-\-wait[=\fR\fB\fIcount\fR\fR\fB]\fR,
  1030. \fB\-w[\fR\fB\fIcount\fR\fR\fB]\fR
  1031. .sp
  1032. If the connection cannot be established, wait and retry instead of aborting\&. If a
  1033. \fIcount\fR
  1034. value is given, it indicates the number of times to retry\&. The default is one time\&.
  1035. .RE
  1036. .PP
  1037. You can also set the following variables by using
  1038. \fB\-\-\fR\fB\fIvar_name\fR\fR\fB=\fR\fB\fIvalue\fR\fR
  1039. The
  1040. \fB\-\-set\-variable\fR
  1041. format is deprecated and is removed in MySQL 5\&.5\&. syntax:
  1042. .sp
  1043. .RS 4
  1044. .ie n \{\
  1045. \h'-04'\(bu\h'+03'\c
  1046. .\}
  1047. .el \{\
  1048. .sp -1
  1049. .IP \(bu 2.3
  1050. .\}
  1051. .\" connect_timeout variable
  1052. .\" timeout: connect_timeout variable
  1053. connect_timeout
  1054. .sp
  1055. The maximum number of seconds before connection timeout\&. The default value is 43200 (12 hours)\&.
  1056. .RE
  1057. .sp
  1058. .RS 4
  1059. .ie n \{\
  1060. \h'-04'\(bu\h'+03'\c
  1061. .\}
  1062. .el \{\
  1063. .sp -1
  1064. .IP \(bu 2.3
  1065. .\}
  1066. .\" shutdown_timeout variable
  1067. .\" timeout: shutdown_timeout variable
  1068. shutdown_timeout
  1069. .sp
  1070. The maximum number of seconds to wait for server shutdown\&. The default value is 3600 (1 hour)\&.
  1071. .RE
  1072. .SH "COPYRIGHT"
  1073. .br
  1074. .PP
  1075. Copyright 2007-2008 MySQL AB, 2008-2010 Sun Microsystems, Inc.
  1076. .PP
  1077. This documentation is free software; you can redistribute it and/or modify it only under the terms of the GNU General Public License as published by the Free Software Foundation; version 2 of the License.
  1078. .PP
  1079. This documentation is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.
  1080. .PP
  1081. You should have received a copy of the GNU General Public License along with the program; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA or see http://www.gnu.org/licenses/.
  1082. .sp
  1083. .SH "SEE ALSO"
  1084. For more information, please refer to the MySQL Reference Manual,
  1085. which may already be installed locally and which is also available
  1086. online at http://dev.mysql.com/doc/.
  1087. .SH AUTHOR
  1088. Sun Microsystems, Inc. (http://www.mysql.com/).