home *** CD-ROM | disk | FTP | other *** search
/ Complete Linux / Complete Linux.iso / docs / apps / database / postgres / postgre2.z / postgre2 / ref / unix / createdb next >
Encoding:
Text File  |  1992-08-27  |  1.5 KB  |  68 lines
  1. .\" XXX standard disclaimer belongs here....
  2. .\" $Header: /private/postgres/ref/unix/RCS/createdb,v 1.15 1992/07/14 05:54:17 ptong Exp $
  3. .SP CREATEDB UNIX 6/14/90
  4. .XA 1 Createdb
  5. .uh NAME
  6. .lp
  7. createdb \*- create a database
  8. .uh SYNOPSIS
  9. .lp
  10. .(l
  11. \fBcreatedb\fR [\fB-p\fR port] [\fB-h\fR host] username
  12. .)l
  13. .uh DESCRIPTION
  14. .lp
  15. .b Createdb
  16. creates a new database.
  17. The person who executes this command
  18. becomes the database administrator
  19. .r ( \c
  20. .A DBA )
  21. for this database.
  22. The
  23. .A DBA
  24. has special powers
  25. not granted to ordinary users. Namely, they can destroy
  26. the database they created.
  27. .lp
  28. .i Dbname
  29. is the name of the database
  30. to be created.
  31. The name must be unique
  32. among all \*(PP databases.
  33. .lp
  34. The argument 
  35. .i port
  36. and
  37. .i hostname
  38. are the same as in the terminal monitor - they are used to connect to the
  39. postmaster using the TCP/IP port
  40. .i port
  41. running on the database server
  42. .i hostname.
  43. The defaults are to the local machine (localhost) and to the default port
  44. (4321).
  45. .lp
  46. .uh "SEE ALSO"
  47. .lp
  48. destroydb(unix), initdb(unix), createdb(commands).
  49. .uh DIAGNOSTICS
  50. .sp
  51. .lp
  52. \fBError: Failed to connect to backend (host=\fIxxx\fB, port=\fIxxx\fB)\fR
  53. .lp
  54. createdb could not attach to the postmaster on the specified host and
  55. port.  If you see this message, check that the postmaster is running on
  56. the proper host and that the proper port is specified.
  57. .sp
  58. .lp
  59. \fBYou are not a valid POSTGRES user\fR
  60. .lp
  61. You do not have a users file entry, and can
  62. not do anything with \*(PP at all.
  63. .sp
  64. .lp
  65. \fI<dbname>\fR \fBalready exists\fR
  66. .lp
  67. The database already exists.
  68.