{
    "content": [
        {
            "type": "text",
            "text": "# debsnap(1) (man)\n\n**Summary:** debsnap - retrieve old snapshots of Debian packages\n\n**Synopsis:** debsnap [options] package [version]\ndebsnap [-h | --help] [--version]\n\n## Flags\n\n| Flag | Long | Arg | Description |\n|------|------|-----|-------------|\n| -d | --destdir | — | Directory to place retrieved packages. |\n| -f | --force | — | Force writing into an existing destination. By default debsnap will insist the desti‐ nation directory does not exist ye |\n| -v | --verbose | — | Report on the debsnap configuration being used and progress during the download opera‐ tion. Please always use this opti |\n| — | --binary | — | Download binary packages instead of source packages. |\n| -a | --architecture | — | Specify architecture of downloaded binary packages. Implies --binary. This can be given multiple times in order to downl |\n| — | --first | — | Specify the minimum version of a package which will be downloaded. Any versions which compare larger than this, accordin |\n| -h | --help | — | Show a summary of these options. |\n| — | --version | — | Show the version of debsnap. |\n\n## Examples\n\n- `Download the binary package of a specific xterm version for amd64 architecture.`\n- `Download binary packages for all versions of xterm for armel architecture.`\n- `Download binary packages for a specific xterm version but for all architectures.`\n- `Download binary packages for all versions of xterm for all architectures.`\n- `Download source packages for local architecture of xterm, between 347-1 and 348-2  re‐`\n- `visions, inclusive, showing the progress when doing it.`\n- `Download binary packages of all packages that are installed on the system.`\n\n## See Also\n\n- devscripts(1)\n- devscripts.conf(5)\n- git-debimport(1)\n\n## Section Outline\n\n- **NAME** (3 lines)\n- **SYNOPSIS** (6 lines)\n- **DESCRIPTION** (12 lines)\n- **OPTIONS** (3 lines) — 8 subsections\n  - -d --destdir (3 lines)\n  - -f --force (7 lines)\n  - -v --verbose (7 lines)\n  - --binary (3 lines)\n  - -a --architecture (4 lines)\n  - --first (10 lines)\n  - -h --help (3 lines)\n  - --version (4 lines)\n- **CONFIGURATION OPTIONS** (19 lines)\n- **EXIT STATUS** (6 lines)\n- **EXAMPLES** (1 lines) — 7 subsections\n  - debsnap -a amd64 xterm 256-1 (2 lines)\n  - debsnap -a armel xterm (2 lines)\n  - debsnap --binary xterm 256-1 (2 lines)\n  - debsnap --binary xterm (2 lines)\n  - debsnap -v --first 347-1 --last 348-2 xterm (3 lines)\n  - aptitude  search  '~i'  -F  '%p  %V'  | while read pkg ver;  (1 lines)\n  - -qDEB -a (3 lines)\n- **FILES** (7 lines)\n- **SEE ALSO** (3 lines)\n- **AUTHORS** (3 lines)\n- **COPYRIGHT** (10 lines)\n- **BUGS** (1 lines) — 1 subsections\n  - Reporting bugs (7 lines)\n\n## Full Content\n\n### NAME\n\ndebsnap - retrieve old snapshots of Debian packages\n\n### SYNOPSIS\n\ndebsnap [options] package [version]\n\ndebsnap [-h | --help] [--version]\n\n### DESCRIPTION\n\ndebsnap  is  a  tool  to  help with retrieving snapshots of old packages from a daily archive\nrepository.\n\nThe only publicly available snapshot archive is  currently  located  at  https://snapshot.de‐\nbian.org\n\nBy  default,  debsnap  will download all the available versions for package that are found in\nthe snapshot archive.  If a version is specified, only that particular version will be  down‐\nloaded, if available.\n\n### OPTIONS\n\nThe following options are available:\n\n#### -d --destdir\n\nDirectory to place retrieved packages.\n\n#### -f --force\n\nForce writing into an existing destination.  By default debsnap will insist the desti‐\nnation directory does not exist yet unless it is explicitly specified to be  '.'  (the\ncurrent  working directory).  This is to avoid files being accidentally overwritten by\nwhat is fetched from the archive and to provide a guarantee  for  other  scripts  that\nonly the files fetched will be present there upon completion.\n\n#### -v --verbose\n\nReport on the debsnap configuration being used and progress during the download opera‐\ntion.  Please always use this option when reporting bugs.\n\n\n--list Don't download but just list versions.\n\n#### --binary\n\nDownload binary packages instead of source packages.\n\n#### -a --architecture\n\nSpecify architecture of downloaded binary packages. Implies  --binary.   This  can  be\ngiven multiple times in order to download binary packages for multiple architectures.\n\n#### --first\n\nSpecify the minimum version of a package which will be downloaded.  Any versions which\ncompare larger than this, according to dpkg, will be considered for download.  May  be\nused in combination with --last.\n\n\n--last Specify  the  maximum version of a package which will be downloaded.  Any package ver‐\nsions which compare less than this, according to dpkg, will be  considered  for  down‐\nload.  May be used in combination with --first.\n\n#### -h --help\n\nShow a summary of these options.\n\n#### --version\n\nShow the version of debsnap.\n\n### CONFIGURATION OPTIONS\n\ndebsnap  may  also  be  configured through the use of the following options in the devscripts\nconfiguration files:\n\n\nDEBSNAPVERBOSE\nSame as the command line option --verbose.  Set to yes to enable.\n\n\nDEBSNAPDESTDIR\nSet a default path for the destination directory.   If  unset  ./source-<packagename>\nwill be used.  The command line option --destdir will override this.\n\n\nDEBSNAPBASEURL\nThe base url for the snapshots archive.\n\nIf unset this defaults to https://snapshot.debian.org\n\n### EXIT STATUS\n\ndebsnap  will  return an exit status of 0 if all operations succeeded, 1 if a fatal error oc‐\ncurred, and 2 if some packages failed to be downloaded but operations otherwise succeeded  as\nexpected.  In some cases packages may fail to be downloaded because they are no longer avail‐\nable on the snapshot mirror, so any caller should expect this may occur in normal use.\n\n### EXAMPLES\n\n#### debsnap -a amd64 xterm 256-1\n\nDownload the binary package of a specific xterm version for amd64 architecture.\n\n#### debsnap -a armel xterm\n\nDownload binary packages for all versions of xterm for armel architecture.\n\n#### debsnap --binary xterm 256-1\n\nDownload binary packages for a specific xterm version but for all architectures.\n\n#### debsnap --binary xterm\n\nDownload binary packages for all versions of xterm for all architectures.\n\n#### debsnap -v --first 347-1 --last 348-2 xterm\n\nDownload source packages for local architecture of xterm, between 347-1 and 348-2  re‐\nvisions, inclusive, showing the progress when doing it.\n\n#### aptitude  search  '~i'  -F  '%p  %V'  | while read pkg ver; do debsnap -a $(dpkg-architecture\n\n#### -qDEB -a\n\nDownload binary packages of all packages that are installed on the system.\n\n### FILES\n\n/etc/devscripts.conf\nGlobal devscripts configuration options.  Will override hardcoded defaults.\n\n~/.devscripts\nPer-user configuration options.  Will override any global configuration.\n\n### SEE ALSO\n\ndevscripts(1), devscripts.conf(5), git-debimport(1)\n\n### AUTHORS\n\nDavid Paleino <dapal@debian.org>\n\n### COPYRIGHT\n\nCopyright © 2010 David Paleino\n\nPermission is granted to copy, distribute and/or modify this document under the terms of  the\nGNU  General Public License, Version 3 or (at your option) any later version published by the\nFree Software Foundation.\n\nOn Debian systems, the complete text of the GNU  General  Public  License  can  be  found  in\n/usr/share/common-licenses/GPL.\n\n### BUGS\n\n#### Reporting bugs\n\nThe  program  is  part  of  the  devscripts package.  Please report bugs using `reportbug de‐‐\nvscripts`\n\n\n\n\nDebian devscripts                           July 3, 2010                                  DEBSNAP(1)\n\n"
        }
    ],
    "structuredContent": {
        "command": "debsnap",
        "section": "1",
        "mode": "man",
        "summary": "debsnap - retrieve old snapshots of Debian packages",
        "synopsis": "debsnap [options] package [version]\ndebsnap [-h | --help] [--version]",
        "flags": [
            {
                "flag": "-d",
                "long": "--destdir",
                "arg": null,
                "description": "Directory to place retrieved packages."
            },
            {
                "flag": "-f",
                "long": "--force",
                "arg": null,
                "description": "Force writing into an existing destination. By default debsnap will insist the desti‐ nation directory does not exist yet unless it is explicitly specified to be '.' (the current working directory). This is to avoid files being accidentally overwritten by what is fetched from the archive and to provide a guarantee for other scripts that only the files fetched will be present there upon completion."
            },
            {
                "flag": "-v",
                "long": "--verbose",
                "arg": null,
                "description": "Report on the debsnap configuration being used and progress during the download opera‐ tion. Please always use this option when reporting bugs. --list Don't download but just list versions."
            },
            {
                "flag": "",
                "long": "--binary",
                "arg": null,
                "description": "Download binary packages instead of source packages."
            },
            {
                "flag": "-a",
                "long": "--architecture",
                "arg": null,
                "description": "Specify architecture of downloaded binary packages. Implies --binary. This can be given multiple times in order to download binary packages for multiple architectures."
            },
            {
                "flag": "",
                "long": "--first",
                "arg": null,
                "description": "Specify the minimum version of a package which will be downloaded. Any versions which compare larger than this, according to dpkg, will be considered for download. May be used in combination with --last. --last Specify the maximum version of a package which will be downloaded. Any package ver‐ sions which compare less than this, according to dpkg, will be considered for down‐ load. May be used in combination with --first."
            },
            {
                "flag": "-h",
                "long": "--help",
                "arg": null,
                "description": "Show a summary of these options."
            },
            {
                "flag": "",
                "long": "--version",
                "arg": null,
                "description": "Show the version of debsnap."
            }
        ],
        "examples": [
            "Download the binary package of a specific xterm version for amd64 architecture.",
            "Download binary packages for all versions of xterm for armel architecture.",
            "Download binary packages for a specific xterm version but for all architectures.",
            "Download binary packages for all versions of xterm for all architectures.",
            "Download source packages for local architecture of xterm, between 347-1 and 348-2  re‐",
            "visions, inclusive, showing the progress when doing it.",
            "Download binary packages of all packages that are installed on the system."
        ],
        "see_also": [
            {
                "name": "devscripts",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/devscripts/1/json"
            },
            {
                "name": "devscripts.conf",
                "section": "5",
                "url": "https://www.chedong.com/phpMan.php/man/devscripts.conf/5/json"
            },
            {
                "name": "git-debimport",
                "section": "1",
                "url": "https://www.chedong.com/phpMan.php/man/git-debimport/1/json"
            }
        ],
        "section_outline": [
            {
                "name": "NAME",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "SYNOPSIS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "DESCRIPTION",
                "lines": 12,
                "subsections": []
            },
            {
                "name": "OPTIONS",
                "lines": 3,
                "subsections": [
                    {
                        "name": "-d --destdir",
                        "lines": 3,
                        "flag": "-d",
                        "long": "--destdir"
                    },
                    {
                        "name": "-f --force",
                        "lines": 7,
                        "flag": "-f",
                        "long": "--force"
                    },
                    {
                        "name": "-v --verbose",
                        "lines": 7,
                        "flag": "-v",
                        "long": "--verbose"
                    },
                    {
                        "name": "--binary",
                        "lines": 3,
                        "long": "--binary"
                    },
                    {
                        "name": "-a --architecture",
                        "lines": 4,
                        "flag": "-a",
                        "long": "--architecture"
                    },
                    {
                        "name": "--first",
                        "lines": 10,
                        "long": "--first"
                    },
                    {
                        "name": "-h --help",
                        "lines": 3,
                        "flag": "-h",
                        "long": "--help"
                    },
                    {
                        "name": "--version",
                        "lines": 4,
                        "long": "--version"
                    }
                ]
            },
            {
                "name": "CONFIGURATION OPTIONS",
                "lines": 19,
                "subsections": []
            },
            {
                "name": "EXIT STATUS",
                "lines": 6,
                "subsections": []
            },
            {
                "name": "EXAMPLES",
                "lines": 1,
                "subsections": [
                    {
                        "name": "debsnap -a amd64 xterm 256-1",
                        "lines": 2
                    },
                    {
                        "name": "debsnap -a armel xterm",
                        "lines": 2
                    },
                    {
                        "name": "debsnap --binary xterm 256-1",
                        "lines": 2
                    },
                    {
                        "name": "debsnap --binary xterm",
                        "lines": 2
                    },
                    {
                        "name": "debsnap -v --first 347-1 --last 348-2 xterm",
                        "lines": 3
                    },
                    {
                        "name": "aptitude  search  '~i'  -F  '%p  %V'  | while read pkg ver; do debsnap -a $(dpkg-architecture",
                        "lines": 1
                    },
                    {
                        "name": "-qDEB -a",
                        "lines": 3,
                        "flag": "-a"
                    }
                ]
            },
            {
                "name": "FILES",
                "lines": 7,
                "subsections": []
            },
            {
                "name": "SEE ALSO",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "AUTHORS",
                "lines": 3,
                "subsections": []
            },
            {
                "name": "COPYRIGHT",
                "lines": 10,
                "subsections": []
            },
            {
                "name": "BUGS",
                "lines": 1,
                "subsections": [
                    {
                        "name": "Reporting bugs",
                        "lines": 7
                    }
                ]
            }
        ]
    }
}