diff --git a/src/bin/pg_dump/README b/src/bin/pg_dump/README new file mode 100644 index 5015b7c..280028a *** a/src/bin/pg_dump/README --- b/src/bin/pg_dump/README *************** Notes on pg_dump *** 5,77 **** 1. pg_dump, by default, still outputs text files. ! 2. pg_dumpall forces all pg_dump output to be text, since it also outputs text into the same output stream. 3. The plain text output format cannot be used as input into pg_restore. - To dump a database into the new custom format, type: - - pg_dump -Fc > - - or, to dump in TAR format - - pg_dump -Ft > - - To restore, try - - To list contents: - - pg_restore -l | less - - or to list tables: - - pg_restore --table | less - - or to list in a different order - - pg_restore -l --oid --rearrange | less - - Once you are happy with the list, just remove the '-l', and an SQL script will be output. - - - You can also dump a listing: - - pg_restore -l > toc.lis - or - pg_restore -l -f toc.lis - - edit it, and rearrange the lines (or delete some): - - vi toc.lis - - then use it to restore selected items: - - pg_restore --use=toc.lis -l | less - - When you like the list, type - - pg_restore backup.bck --use=toc.lis > script.sql - - or, simply: - - createdb newdbname - pg_restore backup.bck --use=toc.lis | psql newdbname - - TAR === ! The TAR archive that pg_dump creates currently has a blank username & group for the files, ! but should be otherwise valid. It also includes a 'restore.sql' script which is there for ! the benefit of humans. The script is never used by pg_restore. ! Note: the TAR format archive can only be used as input into pg_restore if it is in TAR form. ! (ie. you should not extract the files then expect pg_restore to work). ! You can extract, edit, and tar the files again, and it should work, but the 'toc' ! file should go at the start, the data files be in the order they are used, and ! the BLOB files at the end. Philip Warner, 16-Jul-2000 --- 5,31 ---- 1. pg_dump, by default, still outputs text files. ! 2. pg_dumpall forces all pg_dump output to be text, since it also outputs ! text into the same output stream. 3. The plain text output format cannot be used as input into pg_restore. TAR === ! The TAR archive that pg_dump creates currently has a blank username & group ! for the files, but should be otherwise valid. It also includes a 'restore.sql' ! script which is there for the benefit of humans. The script is never used by ! pg_restore. ! Note: the TAR format archive can only be used as input into pg_restore if it ! is in TAR form (i.e. you should not extract the files then expect pg_restore ! to work). ! You can extract, edit, and tar the files again, and it should work, but the ! 'toc' file should go at the start, the data files be in the order they are ! used, and the BLOB files at the end. Philip Warner, 16-Jul-2000