path: root/Documentation/pbuilder-doc.ja.po

# pbuilder-doc documentation
# Copyright (C) 2007 Junichi Uekawa
# Junichi Uekawa <dancer@debian.org>, 2007
#
#
#, fuzzy
msgid ""
msgstr ""
"Project-Id-Version: xxx\n"
"POT-Creation-Date: 2007-05-14 22:56+0900\n"
"PO-Revision-Date: 2007-05-14 23:02+0900\n"
"Last-Translator: Junichi Uekawa <dancer@debian.org>\n"
"Language-Team: Junichi Uekawa <dancer@debian.org>\n"
"MIME-Version: 1.0\n"
"Content-Type: text/plain; charset=utf-8\n"
"Content-Transfer-Encoding: utf-8\n"

# type: Attribute 'xml:lang' of: <book>
#: pbuilder-doc.xml:5
msgid "en"
msgstr "ja"

# type: Content of: <book><bookinfo><date>
#: pbuilder-doc.xml:7
msgid "2007-4-10"
msgstr "2007年4月10日"

# type: Content of: <book><bookinfo><title>
#: pbuilder-doc.xml:8
msgid "pbuilder User's Manual"
msgstr "pbuilder　ユーザマニュアル"

# type: Content of: <book><bookinfo><abbrev>
#: pbuilder-doc.xml:9
msgid "pbuilder-doc"
msgstr "pbuilder-doc"

# type: Content of: <book><bookinfo><subtitle>
#: pbuilder-doc.xml:10
msgid "Usage and operations"
msgstr "利用と操作"

# type: Content of: <book><bookinfo><releaseinfo>
#: pbuilder-doc.xml:11
msgid "documentation in progress"
msgstr "作業中"

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:22
msgid "Introducing pbuilder"
msgstr "pbuilder の紹介"

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:24
msgid "Aims of pbuilder"
msgstr "pbuilder の目的"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:26
msgid ""
"<command>pbuilder</command> stands for Personal Builder, and it is an "
"automatic Debian Package Building system for personal development "
"workstation environments.  <command>pbuilder</command> aims to be an easy-to-"
"setup system for auto-building Debian packages inside a clean-room "
"environment, so that it is possible to verify that a package can be built on "
"most Debian installations.  The clean-room environment is achieved through "
"the use of a chroot image, so that only minimal packages will be installed "
"inside the chroot."
msgstr ""
"<command>pbuilder</command> は Personal Builder の略です。個人的なワークス"
"テーションなどの開発環境で、Debianパッケージをビルドするためのシステムです。"
"<command>pbuilder</command> はパッケージが Debian のインストール環境のほとん"
"どでビルドできることを確認するため、Debianパッケージをクリーンルーム内部で自"
"動にビルドするシステムとして簡単に利用できるようになることを目指しています。"
"クリーンルーム環境は最小限のパッケージを chroot にインストールすることで "
"chroot イメージの活用で実現しています。"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:40
msgid ""
"The Debian distribution consists of free software accompanied with source.  "
"The source code within Debian's \"main\" section must build within Debian "
"\"main\", with only the explicitly specified build-dependencies installed."
msgstr ""
"Debian ディストリビューションはソースコードつきのフリーソフトウェアにより構成"
"されています。Debianの「main」セクションにあるソフトウェアは、Build-depend "
"（ビルド時依存関係）として指定されたDebianの「main」セクションにあるパッケー"
"ジのみがインストールされている状態でビルドできなければなりません。"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:48
msgid ""
"The primary aim of <command>pbuilder</command> is different from other auto-"
"building systems in Debian in that its aim is not to try to build as many "
"packages as possible.  It does not try to guess what a package needs, and in "
"most cases it tries the worst choice of all if there is a choice to be made."
msgstr ""
"主なる <command>pbuilder</command> の目的は、他の自動ビルドシステムとは違いま"
"す。それは、パッケージをできるだけビルドできるようなことを目的としていないと"
"ころです。パッケージが何を必要としているのかを想像しようとはしません。また選"
"択が可能であれば、最悪な選択をする場合もあります。"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:56
msgid ""
"In this way, <command>pbuilder</command> tries to ensure that packages "
"tested against <command>pbuilder</command> will build properly in most "
"Debian installations, hopefully resulting in a good overall Debian source-"
"buildability."
msgstr ""
"この方針を採用することで、 <command>pbuilder</command> は、 "
"<command>pbuilder</command> で試験したパッケージはほとんどのDebianがインス"
"トールされた環境でビルドできるように確認することができます。これによって"
"Debian全体としてのソースコードのビルドしやすさの向上を目指しています。"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:63
msgid ""
"The goal of making Debian buildable from source is somewhat accomplished, "
"and has seen good progress.  In the past age of Debian 3.0, there were many "
"problems when building from source.  More recent versions of Debian is much "
"better."
msgstr "Debian をソースからビルドできるようにするという目標はほぼ完了し、よく進捗しています。Debian 3.0の時代ではソースからビルドするのに問題が多数ありましたが、最近のリリースではましになってきています。"

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:71
msgid "Using pbuilder"
msgstr "pbuilder を利用する"

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:73
msgid ""
"There are several simple commands for operation.  <command>pbuilder create</"
"command>, <command>pbuilder update</command>, and <command>pbuilder build</"
"command> commands are the typical commands used.  Let us look at the "
"commands one by one."
msgstr "操作には、いくつかの簡単なコマンドがあります。<command>pbuilder create</command>、 <command>pbuilder update</command>、そして <command>pbuilder build</command> コマンドがよく使われます。ひとつづつ見ていきましょう。"

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:80
msgid "Creating a base chroot image"
msgstr "base chroot イメージの作成"

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:82
msgid ""
"<command>pbuilder create</command> will create a base chroot image.  All "
"other commands will operate on the resulting base chroot image.  If the "
"Debian release to be created within chroot is not going to be \"sid\" (which "
"is the default), the distribution code-name needs to be specified with the "
"<command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:89
msgid "--distribution"
msgstr "--distribution"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:89 pbuilder-doc.xml:155
msgid "</command> command-line option."
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:94
msgid "debootstrap or cdebootstrap can be chosen"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:95
msgid ""
"</footnote> is used to create the bare minimum Debian installation, and then "
"build-essential packages are installed on top of the minimum installation "
"using <command>apt-get</command> inside the chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:103
msgid ""
"For fuller documentation of command-line options, see the pbuilder.8 manual "
"page.  Some configuration will be required for <filename>/etc/pbuilderrc</"
"filename> for the mirror site <footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:109
msgid ""
"The mirror site should preferably be a local mirror or a cache server, so as "
"not to overload the public mirrors with a lot of access.  Use of tools such "
"as apt-proxy would be advisable."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:115
msgid ""
"</footnote> to use, and proxy configuration may be required to allow access "
"through HTTP.  See the pbuilderrc.5 manual page for details."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:122
msgid "Updating the base chroot image"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:123
msgid ""
"<command>pbuilder update</command> will update the chroot image.  It will "
"extract the chroot, invoke <command>apt-get update</command> and "
"<command>apt-get dist-upgrade</command> inside the chroot, and then recreate "
"the base tar-ball."
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:130
msgid ""
"It is possible to switch the distribution which the chroot tar-ball is "
"targeted at at this point.  Specify <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:132
msgid "--distribution <parameter>sid</parameter>"
msgstr "--distribution <parameter>sid</parameter>"

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:132
msgid "--override-config"
msgstr "--override-config"

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:132
msgid "</command> to change the distribution to sid.  <footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:135
msgid ""
"Only upgrading is supported.  Debian does not generally support downgrading "
"(yet?)."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:140 pbuilder-doc.xml:170
msgid ""
"For fuller documentation of command-line options, see the pbuilder.8 manual "
"page"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:145
msgid "Building a package using the chroot image"
msgstr "chroot イメージを利用してパッケージをビルドする"

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:147
msgid "To build a package inside the chroot, invoke <command>pbuilder build"
msgstr "chroot 内部でパッケージをビルドするには、 <command>pbuilder build "

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:148
msgid "whatever.dsc"
msgstr "なんたら.dsc"

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:148
msgid ""
"</command>.  <command>pbuilder</command> will extract the chroot image to a "
"temporary working directory, and satisfy the build-dependencies inside the "
"chroot, and build the package.  The built packages will be moved to a "
"directory specified with the <command>"
msgstr "</command>.  <command>pbuilder</command> は chroot イメージを一時作業用のディレクトリに展開し、そのchroot内部でビルド時の依存関係（Build-Depends) を満たし、パッケージをビルドします。ビルドされてできたパッケージは次のコマンドで指定したディレクトリに移動されます： <command>"

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><command><option>
#: pbuilder-doc.xml:155 pbuilder-doc.xml:191 pbuilder-doc.xml:231
msgid "--buildresult"
msgstr "--buildresult"

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:159 pbuilder-doc.xml:1450
msgid "The <command>"
msgstr "<command>"

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:159
msgid "--basetgz"
msgstr "--basetgz"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:159
msgid "</command> option can be used to specify which chroot image to use."
msgstr "</command> オプションはどのchrootイメージを利用するべきかを指定することができます。"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:163
msgid ""
"<command>pbuilder</command> will extract a fresh chroot image created with "
"<command>pbuilder build</command> and updated with <command>pbuilder update</"
"command>, and populate the chroot with build-dependencies by parsing debian/"
"control and invoking <command>apt-get</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:175
msgid "Facilitating Debian Developers' typing, pdebuild"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:177
msgid ""
"<command>pdebuild</command> is a little wrapper script that does the most "
"frequent of all tasks.  A Debian Developer may try to do <command>debuild</"
"command>, and build a package, inside a Debian source directory.  "
"<command>pdebuild</command> will allow similar control, and allow package to "
"be built inside the chroot, to check that the current source tree will build "
"happily inside the chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:187
msgid ""
"<command>pdebuild</command> calls <command>dpkg-source</command> to build "
"the source packages, and then invokes <command>pbuilder</command> on the "
"resulting source package.  However, unlike debuild, the resulting deb files "
"will be found in the <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:191
msgid "</command> directory."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:195
msgid "See the pdebuild.1 manual page for more details."
msgstr "詳細は pdebuild.1 マニュアルページを参照してください。"

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:198
msgid ""
"There is a slightly different mode of operation available in "
"<command>pdebuild</command> since version 0.97. <command>pdebuild</command> "
"usually runs <command>debian/rules clean</command> outside of the chroot; "
"however, it is possible to change the behaviour to run it inside the chroot "
"with the <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:203 pbuilder-doc.xml:1108
msgid "--use-pdebuild-internal"
msgstr "--use-pdebuild-internal"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:203
msgid ""
"</command>.  It will try to bind mount the working directory inside chroot, "
"and run <command>dpkg-buildpackage</command> inside.  It has the following "
"characteristics, and is not yet the default mode of operation."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:212
msgid ""
"Satisfies build-dependency inside the chroot before creating source "
"package.  (which is a good point that current <command>pdebuild</command> "
"cannot do)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:217
msgid "The working directory is modified from inside the chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:221
msgid ""
"Building with <command>pdebuild</command> does not guarantee that it works "
"with <command>pbuilder</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:225
msgid ""
"If making the source package fails, the session using the chroot is wasted "
"(chroot creation takes a bit of time, which should be improved with "
"cowdancer)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><command>
#: pbuilder-doc.xml:230
msgid "Does not work in the same manner as it used to; for example, <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:231
msgid "</command> does not have any effect."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:235
msgid "The build inside chroot is ran with the current user outside chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:241
msgid "Configuration Files"
msgstr "設定ファイル"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:243
msgid ""
"It is possible to specify all settings by command-line options. However, for "
"typing convenience, it is possible to use a configuration file."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:248
msgid ""
"<filename>/etc/pbuilderrc</filename> and <filename>${HOME}/.pbuilderrc</"
"filename> are read in when <command>pbuilder</command> is invoked.  The "
"possible options are documented in the pbuilderrc.5 manual page."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:255
msgid "It is useful to use"
msgstr "別のディストリビューション向けに複数の設定ファイルを活用するためには"

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><command><option>
#: pbuilder-doc.xml:255 pbuilder-doc.xml:670
msgid "--configfile"
msgstr "--configfile"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:255
msgid ""
"option to load up a preset configuration file when switching between "
"configuration files for different distributions."
msgstr "オプションが便利です"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:260
msgid ""
"Please note <filename>${HOME}/.pbuilderrc</filename> supersede system "
"settings.  For example, if you are upgrading from sarge to etch, you may "
"need to adjust some part of your local setting just like new <filename>/usr/"
"share/pbuilder/pbuilderrc</filename>, e.g., \"unset DEBOOTSTRAPOPTS\", to "
"cope with the use of cdebootstrap.  The same care is needed if you edited "
"old system setting in <filename>/etc/pbuilderrc</filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:269
msgid "Building packages as non-root inside the chroot"
msgstr "chroot 内部で root 以外でパッケージをビルドする"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:271
msgid ""
"<command>pbuilder</command> requires full root privilege when it is "
"satisfying the build-dependencies, but most packages do not need root "
"privilege, or fail to build when they are root.  <command>pbuilder </"
"command> can create a user which is only used inside <command>pbuilder </"
"command> and use that user id when building, and use the <command>fakeroot</"
"command> command when root privilege is required."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:280
msgid ""
"BUILDUSERID configuration option should be set to a value for a user id that "
"does not already exist on the system, so that it is more difficult for "
"packages that are being built with <command>pbuilder</command> to affect the "
"environment outside the chroot.  When BUILDUSERNAME configuration option is "
"also set, <command>pbuilder</command> will use the specified user name and "
"fakeroot for building packages, instead of running as root inside chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:289
msgid ""
"Even when using the fakerooting method, <command>pbuilder</command> will run "
"with root privilege when it is required.  For example, when installing "
"packages to the chroot, <command>pbuilder</command> will run under root "
"privilege."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:295
msgid ""
"To be able to invoke <command>pbuilder</command> without being root, you "
"need to use user-mode-linux, as explained in <xref linkend=\"pbuilder-uml\"/"
">."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:301
msgid "Using pbuilder for back-porting"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:303
msgid ""
"<command>pbuilder</command> can be used for back-porting software from the "
"latest Debian distribution to the older stable distribution, by using a "
"chroot that contains an image of the older distribution, and building "
"packages inside the chroot.  There are several points to consider, and due "
"to the following reasons, automatic back-porting is usually not possible, "
"and manual interaction is required:"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:314
msgid ""
"The package from the unstable distribution may depend on packages or "
"versions of packages which are only available in unstable.  Thus, it may not "
"be possible to satisfy Build-Depends: on stable (without additional "
"backporting work)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:321
msgid ""
"The stable distribution may have bugs that have been fixed in unstable which "
"need to be worked around."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:324
msgid ""
"The package in the unstable distribution may have problems building even on "
"unstable."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:330
msgid "Mass-building packages"
msgstr "パッケージを大量にビルドする"

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:332
msgid ""
"<command>pbuilder</command> can be automated, because its operations are non-"
"interactive.  It is possible to run <command>pbuilder</command> through "
"multiple packages non-interactively.  Several such scripts are known to "
"exist.  Junichi Uekawa has been running such a script since 2001, and has "
"been filing bugs on packages that fail the test of <command>pbuilder</"
"command>. There were several problems with auto-building:"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:343
msgid ""
"Build-Dependencies need to install non-interactively, but some packages are "
"so broken that they cannot install without interaction (like postgresql)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:348
msgid ""
"When a library package breaks, or gcc/gcj/g++ breaks, or even bison, a large "
"number of build failures are reported.  (gcj-3.0 which had no \"javac\", "
"bison which got more strict, etc.)"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:354
msgid "Some people were quite hostile against build failure reports."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:358
msgid ""
"Most of the initial bugs have been resolved in the <command>pbuilder</"
"command> sweep done around 2002, but these transitional problems which "
"affect a large portion of Debian Archive do arise from time to time.  "
"Regression tests have their values."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:364
msgid ""
"A script that was used by Junichi Uekawa is now included in the "
"<command>pbuilder</command> distribution, as <command>pbuildd.sh</command>.  "
"It is available in <filename>/usr/share/doc/pbuilder/examples/pbuildd/</"
"filename> and its configuration is in <filename>/etc/pbuilder/pbuildd-config."
"sh</filename>.  It should be easy enough to set up for people who are used "
"to <command>pbuilder</command>. It has been running for quite a while, and "
"it should be possible to set the application up on your system also.  "
"However, it is a new introduction, and please file bugs to the Debian BTS if "
"you know of possible problems, or improved on the script considerably."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:376
msgid "To set up pbuildd, there are some points to be aware of."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:380
msgid ""
"A file <filename>./avoidlist</filename> needs to be available with the list "
"of packages to avoid building."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:383
msgid ""
"It will try building anything, even packages which are not aimed for your "
"architecture."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:387
msgid ""
"Because you are running random build scripts, it is better to use the "
"fakeroot option of <command>pbuilder</command>, to avoid running the build "
"under root privilege."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:392
msgid ""
"Because not all builds are guaranteed to finish in a finite time, setting a "
"timeout is probably necessary, or pbuildd may stall with a bad build."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:398
msgid ""
"Some packages require a lot of disk space, around 2GB seems to be sufficient "
"for the largest packages for the time being.  If you find otherwise, please "
"inform the maintainer of this documentation."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:406
msgid "Auto-backporting scripts"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:408
msgid ""
"There are some people who use <command>pbuilder</command> to automatically "
"back-port a subset of packages to the stable distribution."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:412
msgid ""
"I would like some information on how people are doing it, I would appreciate "
"any feedback or information on how you are doing, or any examples."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:418
msgid "Using pbuilder for automated testing of packages"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:420
msgid ""
"<command>pbuilder</command> can be used for automated testing of packages.  "
"It has the feature of allowing hooks to be placed, and these hooks can try "
"to install packages inside the chroot, or run them, or whatever else that "
"can be done. Some known tests and ideas:"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:428
msgid ""
"Automatic install-remove-upgrade-remove-install-purge-upgrade-purge test-"
"suite (distributed as an example, <filename>B91dpkg-i</filename>), or just "
"check that everything installs somewhat (<filename>execute_installtest.sh</"
"filename>)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:433
msgid ""
"Automatically running lintian/linda (distributed as an example in <filename>/"
"usr/share/doc/pbuilder/examples/B90linda</filename>)."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:437
msgid ""
"Automatic debian-test of the package? The debian-test package has been "
"removed from Debian.  A <command>pbuilder</command> implementation can be "
"found as debian/pbuilder-test directory, implemented through B92test-pkg "
"script."
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:444
msgid ""
"To use B92test-pkg script, first, add it to your hook directory.  <footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:446
msgid ""
"It is possible to specify <command>--hookdir /usr/share/doc/pbuilder/"
"examples</command> command-line option to include all example hooks as well."
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:449
msgid ""
"</footnote>.  The test files are shell scripts placed in <filename>debian/"
"pbuilder-test/NN_name</filename> (where NN is number) following run-parts "
"standard<footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:454
msgid "See run-parts(8). For example, no '.' in file names!"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:457
msgid ""
"</footnote> for file names.  After a successful build, packages are first "
"tested for installation and removal, and then each test is ran inside the "
"chroot.  The current directory is the top directory of the source-code.  "
"This means you can expect to be able to use ./debian/ directory from inside "
"your scripts."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:466
msgid "Using pbuilder for testing builds with alternate compilers"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:468
msgid ""
"Most packages are compiled with <command>gcc</command> or <command>g++</"
"command> and using the default compiler version, which was gcc 2.95 for "
"Debian GNU/Linux 3.0 (i386).  However, Debian 3.0 was distributed with other "
"compilers, under package names such as <command>gcc-3.2</command> for gcc "
"compiler version 3.2.  It was therefore possible to try compiling packages "
"against different compiler versions.  <command>pentium-builder</command> "
"provides an infrastructure for using a different compiler for building "
"packages than the default gcc, by providing a wrapper script called gcc "
"which calls the real gcc.  To use <command>pentium-builder</command> in "
"<command>pbuilder</command>, it is possible to set up the following in the "
"configuration:"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:482
#, no-wrap
msgid ""
"EXTRAPACKAGES=\"pentium-builder gcc-3.2 g++-3.2\"\n"
"export DEBIAN_BUILDARCH=athlon\n"
"export DEBIAN_BUILDGCCVER=3.2"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:488
msgid ""
"It will instruct <command>pbuilder</command> to install the <command>pentium-"
"builder</command> package and also the GCC 3.2 compiler packages inside the "
"chroot, and set the environment variables required for <command>pentium-"
"builder</command> to function."
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:496
msgid "Using User-mode-linux with pbuilder"
msgstr ""

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:498
msgid ""
"It is possible to use user-mode-linux by invoking <command>pbuilder-user-"
"mode-linux</command> instead of <command>pbuilder</command>.  "
"<command>pbuilder-user-mode-linux</command> doesn't require root privileges, "
"and it uses the copy-on-write (COW) disk access method of <command>User-mode-"
"linux</command> which typically makes it much faster than the traditional "
"<command>pbuilder</command>."
msgstr ""

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:508
msgid ""
"<command>User-mode-linux</command> is a somewhat less proven platform than "
"the standard Unix tools which <command>pbuilder</command> relies on "
"(<command>chroot</command>, <command>tar</command>, and <command>gzip</"
"command>) but mature enough to support <command>pbuilder-user-mode-linux</"
"command> since its version 0.59.  And since then, <command>pbuilder-user-"
"mode-linux</command> has seen a rapid evolution."
msgstr ""

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:519
msgid ""
"The configuration of <command>pbuilder-user-mode-linux</command> goes in "
"three steps:"
msgstr ""

# type: Content of: <book><chapter><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:523
msgid "Configuration of user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:526
msgid "Configuration of rootstrap"
msgstr ""

# type: Content of: <book><chapter><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:529
msgid "Configuration of pbuilder-uml"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:534
msgid "Configuring user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:536
msgid ""
"user-mode-linux isn't completely trivial to set up.  It would probably be "
"useful to acquaint yourself with it a bit before attempting to use "
"<command>rootstrap</command> or <command>pbuilder-user-mode-linux</"
"command>.  For details, read <filename>/usr/share/doc/uml-utilities/README."
"Debian</filename> and the <command>user-mode-linux</command> documentation.  "
"(It's in a separate package, user-mode-linux-doc.)"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:546
msgid ""
"<command>user-mode-linux</command> requires the user to be in the uml-net "
"group in order to configure the network unless you are using slirp."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:551
msgid ""
"If you compile your own kernel, you may want to verify that you enable TUN/"
"TAP support, and you might want to consider the SKAS patch."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:557
msgid "Configuring rootstrap"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:559
msgid ""
"<command>rootstrap</command> is a wrapper around debootstrap.  It creates a "
"Debian disk image for use with UML.  To configure rootstrap, there are "
"several requirements."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:566
msgid "Install the rootstrap package."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:570
msgid ""
"TUN/TAP only: add the user to the uml-net group to allow access to the "
"network"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><screen>
#: pbuilder-doc.xml:573
#, no-wrap
msgid "adduser dancer uml-net"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:577
msgid ""
"TUN/TAP only: Check that the kernel supports the TUN/TAP interface, or "
"recompile the kernel if necessary."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:583
msgid ""
"Set up <filename>/etc/rootstrap/rootstrap.conf</filename>.  For example, if "
"the current host is 192.168.1.2, changing following entries to something "
"like this seems to work."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><screen>
#: pbuilder-doc.xml:588
#, no-wrap
msgid ""
"transport=tuntap\n"
"interface=eth0\n"
"gateway=192.168.1.1\n"
"mirror=http://192.168.1.2:8081/debian\n"
"host=192.168.1.198\n"
"uml=192.168.1.199\n"
"netmask=255.255.255.0"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:596
msgid ""
"Some experimentation with configuration and running <command>rootstrap ~/"
"test.uml</command> to actually test it would be handy."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:601
msgid ""
"Using slirp requires less configuration.  The default configuration comes "
"with a working example."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:608
msgid "Configuring pbuilder-uml"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:610
msgid "The following needs to happen:"
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:613
msgid "Install the pbuilder-uml package."
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:617
msgid ""
"Set up the configuration file <filename>/etc/pbuilder/pbuilder-uml.conf</"
"filename> in the following manner. It will be different for slirp."
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para><screen>
#: pbuilder-doc.xml:621
#, no-wrap
msgid ""
"MY_ETH0=tuntap,,,192.168.1.198\n"
"UML_IP=192.168.1.199\n"
"UML_NETMASK=255.255.255.0\n"
"UML_NETWORK=192.168.1.0\n"
"UML_BROADCAST=255.255.255.255\n"
"UML_GATEWAY=192.168.1.1\n"
"PBUILDER_UML_IMAGE=\"/home/dancer/uml-image\""
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:629
msgid "Also, it needs to match the rootstrap configuration."
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:634
msgid ""
"Make sure BUILDPLACE is writable by the user.  Change BUILDPLACE in the "
"configuration file to a place where the user has access."
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para><command>
#: pbuilder-doc.xml:640
msgid "Run <command>pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para><command><option>
#: pbuilder-doc.xml:640
msgid "create --distribution sid"
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:640
msgid "</command> to create the image."
msgstr ""

# type: Content of: <book><chapter><sect1><para><itemizedlist><listitem><para>
#: pbuilder-doc.xml:643
msgid "Try running <command>pbuilder-user-mode-linux build</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:649
msgid "Considerations for running pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:651
msgid ""
"<command>pbuilder-user-mode-linux</command> emulates most of "
"<command>pbuilder</command>, but there are some differences."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:657
msgid ""
"<command>pbuilder-user-mode-linux</command> does not support all options of "
"<command>pbuilder</command> properly yet. This is a problem, and will be "
"addressed as specific areas are discovered."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><command>
#: pbuilder-doc.xml:664
msgid ""
"/tmp is handled differently inside <command>pbuilder-user-mode-linux</"
"command>.  In <command>pbuilder-user-mode-linux</command>, <filename>/tmp</"
"filename> is mounted as tmpfs inside UML, so accessing files under "
"<filename>/tmp</filename> from outside user-mode-linux does not work.  It "
"affects options like <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:670
msgid ""
"</command>, and when trying to build packages placed under <filename>/tmp</"
"filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:678
msgid "Parallel running of pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:680
msgid ""
"To run <command>pbuilder-user-mode-linux</command> in parallel on a system, "
"there are a few things to bear in mind."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:685
msgid ""
"The create and update methods must not be run when a build is in progress, "
"or the COW file will be invalidated."
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:690
msgid ""
"If you are not using slirp, user-mode-linux processes which are running in "
"parallel need to have different IP addresses.  Just trying to run the "
"<command>pbuilder-user-mode-linux</command> several times will result in "
"failure to access the network.  But something like the following will work:"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para><screen>
#: pbuilder-doc.xml:696
#, no-wrap
msgid ""
"for IP in 102 103 104 105; do\n"
"  xterm -e pbuilder-user-mode-linux build --uml-ip 192.168.0.$IP \\\n"
"    20030107/whizzytex_1.1.1-1.dsc &amp;\n"
"done"
msgstr ""

# type: Content of: <book><chapter><sect1><itemizedlist><listitem><para>
#: pbuilder-doc.xml:701
msgid "When using slirp, this problem does not exist."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:707
msgid ""
"Using pbuilder-user-mode-linux as a wrapper script to start up a virtual "
"machine"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:709
msgid ""
"It is possible to use <command>pbuilder-user-mode-linux</command> for other "
"uses than just building Debian packages.  <command>pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:713 pbuilder-doc.xml:810
msgid "login"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:713
msgid ""
"</command> will let a user use a shell inside the user-mode-linux "
"<command>pbuilder</command> base image, and <command>pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:716
msgid "execute"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:716
msgid "</command> will allow the user to execute a script inside the image."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:720
msgid ""
"You can use the script to install ssh and add a new user, so that it is "
"possible to access inside the user-mode-linux through ssh."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:724
msgid ""
"Note that it is not possible to use a script from <filename>/tmp</filename> "
"due to the way <command>pbuilder-user-mode-linux</command> mounts a tmpfs at "
"<filename>/tmp</filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:730
msgid ""
"The following example script may be useful in starting a sshd inside user-"
"mode-linux."
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:734
#, no-wrap
msgid ""
"#!/bin/bash\n"
"\n"
"apt-get install -y ssh xbase-clients xterm\n"
"echo \"enter root password\"\n"
"passwd\n"
"cp /etc/ssh/sshd_config{,-}\n"
"sed 's/X11Forwarding.*/X11Forwarding yes/' /etc/ssh/sshd_config- &gt; /etc/ssh/sshd_config\n"
"\n"
"/etc/init.d/ssh restart\n"
"ifconfig\n"
"echo \"Hit enter to finish\"\n"
"read"
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:750
msgid "Frequently asked questions"
msgstr ""

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:753
msgid ""
"Here, known problems and frequently asked questions are documented. This "
"portion was initially available in README.Debian file, but moved here."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:758
msgid "pbuilder create fails"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:760
msgid ""
"It often happens that <command>pbuilder</command> cannot create the latest "
"chroot.  Try upgrading <command>pbuilder</command> and debootstrap.  It is "
"currently only possible to create software that handles the past. Future "
"prediction is a feature which may be added later after we have become "
"comfortable with the past."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:767
msgid ""
"There are people who occasionally back port debootstrap to stable versions; "
"hunt for them."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:771
msgid ""
"When there are errors with the debootstrap phase, the debootstrap script "
"needs to be fixed.  <command>pbuilder</command> does not provide a way to "
"work around debootstrap."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:777
msgid "Directories that cannot be bind-mounted"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:779
msgid ""
"Because of the way <command>pbuilder</command> works, there are several "
"directories which cannot be bind-mounted when running <command>pbuilder</"
"command>.  The directories include <filename>/tmp</filename>, <filename>/var/"
"cache/pbuilder</filename>, and system directories such as <filename>/etc</"
"filename> and <filename>/usr</filename>.  The recommendation is to use "
"directories under the user's home directory for bind-mounts."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:790
msgid "Logging in to pbuilder to modify the environment"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:792
msgid ""
"It is sometimes necessary to modify the chroot environment.  <command>login</"
"command> will remove the contents of the chroot after logout.  It is "
"possible to invoke a shell using hook scripts.  <command>pbuilder update</"
"command> executes 'E' scripts, and a sample for invoking a shell is provided "
"as <filename>C10shell</filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:800
#, no-wrap
msgid ""
"$ mkdir ~/loginhooks\n"
"$ cp C10shell ~/loginhooks/E10shell\n"
"$ sudo pbuilder update --hookdir ~/loginhooks/E10shell"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:805
msgid "It is also possible to add"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:805
msgid "--save-after-exec"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:806
msgid "and/or"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:806
msgid "--save-after-login"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:806
msgid ""
"options to the <command>pbuilder login</command> session to accomplish the "
"goal.  It is possible to add the"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:809
msgid "--uml-login-nocow"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:809
msgid "option to <command>pbuilder-user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:810
msgid "</command> session as well."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:815
msgid "Setting BUILDRESULTUID for sudo sessions"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:817
msgid "It is possible to set"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:818
#, no-wrap
msgid "BUILDRESULTUID=$SUDO_UID"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:818
msgid ""
"in pbuilderrc to set the proper BUILDRESULTUID when using <command>sudo</"
"command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:823
msgid "Notes on usage of $TMPDIR"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:825
msgid ""
"If you are setting $TMPDIR to an unusual value, of other than <filename>/"
"tmp</filename>, you will find that some errors may occur inside the chroot, "
"such as <command>dpkg-source</command> failing."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:829
msgid ""
"There are two options, you may install a hook to create that directory, or "
"set"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:831
#, no-wrap
msgid "export TMPDIR=/tmp"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:832
msgid "in pbuilderrc. Take your pick."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:835
msgid ""
"An example script is provided as <filename>examples/D10tmp</filename> with "
"<command>pbuilder</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:840
msgid ""
"Creating a shortcut for running <command>pbuilder</command> with a specific "
"distribution"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:842
msgid ""
"When working with multiple chroots, it would be nice to work with scripts "
"that reduce the amount of typing.  An example script <filename>pbuilder-"
"distribution.sh</filename> is provided as an example.  Invoking the script "
"as <filename>pbuilder-etch</filename> will invoke <command>pbuilder</"
"command> with a etch chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:851
msgid "Using special apt sources lists, and local packages"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:853
msgid ""
"If you have some very specialised requirements on your apt setup inside "
"<command>pbuilder</command>, it is possible to specify that through the "
"<command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:856
msgid "--othermirror"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:856
msgid "</command> option.  Try something like: <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:859
msgid ""
"--othermirror \"deb http://local/mirror stable main|deb-src http://local/"
"source/repository ./\""
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:862
msgid ""
"To use the local file system instead of HTTP, it is necessary to do bind-"
"mounting.  <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:864
msgid "--bindmounts"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:864
msgid "</command> is a command-line option useful for such cases."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:868
msgid ""
"It might be convenient to use your built packages from inside the chroot.  "
"It is possible to automate the task with the following configuration.  "
"First, set up pbuilderrc to bindmount your build results directory."
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:873
#, no-wrap
msgid "BINDMOUNTS=\"/var/cache/pbuilder/result\""
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:877
msgid "Then, add the following hook"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:881
#, no-wrap
msgid ""
"# cat /var/cache/pbuilder/hooks/D70results\n"
"#!/bin/sh\n"
"cd /var/cache/pbuilder/result/\n"
"/usr/bin/dpkg-scanpackages . /dev/null &gt; /var/cache/pbuilder/result/Packages\n"
"/usr/bin/apt-get update"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:889
msgid ""
"This way, you can use <filename>deb file:/var/cache/pbuilder/result</"
"filename>"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:893
msgid ""
"How to get pbuilder to run apt-get update before trying to satisfy build-"
"dependency"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:895
msgid ""
"You can use hook scripts for this.  D scripts are run before satisfying "
"build-dependency."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:905
msgid "Different bash prompts inside pbuilder login"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:907
msgid ""
"To make distinguishing bash prompts inside <command>pbuilder</command> "
"easier, it is possible to set environment variables such as PS1 inside "
"<filename>pbuilderrc</filename>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:913
msgid ""
"With versions of bash more recent than 2.05b-2-15, the value of the "
"debian_chroot variable, if set, is included in the value of PS1 (the Bash "
"prompt)  inside the chroot.  In prior versions of bash,<footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:918
msgid "Versions of bash from and before Debian 3.0"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:919
msgid "</footnote> setting PS1 in pbuilderrc worked."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:922
msgid "example of debian_chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:924
#, no-wrap
msgid "export debian_chroot=\"pbuild$$\""
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:926
msgid "example of PS1"
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:928
#, no-wrap
msgid "export PS1=\"pbuild chroot 32165 # \""
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:932
msgid "Using /var/cache/apt/archives for the package cache"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:934
msgid ""
"For the help of low-bandwidth systems, it is possible to use <filename>/var/"
"cache/apt/archives</filename> as the package cache.  Just specify it instead "
"of the default <filename>/var/cache/pbuilder/aptcache</filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:940
msgid ""
"It is however not possible to do so currently with the user-mode-linux "
"version of <command>pbuilder</command>, because <filename>/var/cache/apt/"
"archives</filename> is usually only writable by root."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:946
msgid ""
"Use of dedicated tools such as apt-proxy is recommended, since caching of "
"packages would benefit the system outside the scope of <command>pbuilder</"
"command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:952
msgid "pbuilder back ported to stable Debian releases"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:954
msgid "Currently stable back port of pbuilder is avialable at backports.org."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:958
msgid "Warning about LOGNAME not being defined"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:960
msgid ""
"You might see a lot of warning messages when running <command>pbuilder</"
"command>."
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:964
#, no-wrap
msgid "dpkg-genchanges: warning: no utmp entry available and LOGNAME not defined; using uid of process (1234)"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:968
msgid ""
"It is currently safe to ignore this warning message.  Please report back if "
"you find any problem with having LOGNAME unset.  Setting LOGNAME caused a "
"few problems when invoking <command>chroot</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:975
msgid "Cannot Build-conflict against an essential package"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:977
msgid ""
"<command>pbuilder</command> does not currently allow Build-Conflicts against "
"essential packages.  It should be obvious that essential packages should not "
"be removed from a working Debian system, and a source package should not try "
"to force removal of such packages on people building the package."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:986
msgid "Avoiding the \"ln: Invalid cross-device link\" message"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:988
msgid ""
"By default, <command>pbuilder</command> uses hard links to manage the "
"<command>pbuilder</command> package cache.  It is not possible to make hard "
"links across different devices; and thus this error will occur, depending on "
"your set up.  If this happens, set"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:992 pbuilder-doc.xml:1156
#, no-wrap
msgid "APTCACHEHARDLINK=no"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:992
msgid "in your pbuilderrc file."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:997
msgid "Using fakechroot"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:999
msgid ""
"It is possible to use <command>fakechroot</command> instead of being root to "
"run <command>pbuilder</command>; however, several things make this "
"impractical.  <command>fakechroot</command> overrides library loads and "
"tries to override default libc functions when providing the functionality of "
"virtual <command>chroot</command>.  However, some binaries do no use libc to "
"function, or override the overriding provided by <command>fakechroot</"
"command>.  One example is <command>ldd</command>.  Inside "
"<command>fakechroot</command>, <command>ldd</command> will check the library "
"dependency outside of the chroot, which is not the expected behaviour."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1013
msgid "To work around the problem, debootstrap has a"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:1014
msgid "--variant fakechroot"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1014
msgid "option.  Use that, so that ldd and ldconfig are overridden."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1018
msgid ""
"Make sure you have set your LD_PRELOAD path correctly, as described in the "
"fakechroot manpage."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1023
msgid "Using debconf inside pbuilder sessions"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1025
msgid ""
"To use debconf inside <command>pbuilder</command>, setting DEBIAN_FRONTEND "
"to <quote>readline</quote> in <filename>pbuilderrc</filename> should work.  "
"Setting it to <quote>dialog</quote> should also work, but make sure whiptail "
"or dialog is installed inside the chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1032
msgid "nodev mount options hinder pbuilder activity"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1034
msgid ""
"If you see messages such as this when building a chroot, you are mounting "
"the file system with the nodev option."
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:1038
#, no-wrap
msgid "/var/lib/dpkg/info/base-files.postinst: /dev/null: Permission denied"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1041
msgid ""
"You will also have problems if you mount the file system with the noexec "
"option, or nosuid.  Make sure you do not have these flags set when mounting "
"the file system for <filename>/var/cache/pbuilder</filename> or $BUILDPLACE."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1047
msgid "This is not a problem when using <command>user-mode-linux</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1050
msgid ""
"See <ulink url=\"http://bugs.debian.org/316135\"> 316135 </ulink> for "
"example."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1056
msgid "pbuilder is slow"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1058
msgid ""
"<command>pbuilder</command> is often slow. The slowest part of "
"<command>pbuilder</command> is extracting the tar.gz every time "
"<command>pbuilder</command> is invoked. That can be avoided by using "
"<command>pbuilder-user-mode-linux</command>.  <command>pbuilder-user-mode-"
"linux</command> uses COW file system, and thus does not need to clean up and "
"recreate the root file system."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1067
msgid ""
"<command>pbuilder-user-mode-linux</command> is slower in executing the "
"actual build system, due to the usual <command>user-mode-linux</command> "
"overhead for system calls. It is more friendly to the hard drive."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1073
msgid ""
"<command>pbuilder</command> with cowdancer is also an alternative that "
"improves speed of pbuilder startup."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1078
msgid "Creating a chroot reminder"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1080
msgid ""
"You may want a sign that you are inside a chroot, when working with chroot.  "
"Check out the <filename>examples/F90chrootmemo</filename> hook script.  It "
"will create a file called <filename>/CHROOT</filename> inside your chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1088
msgid "Using pdebuild to sponsor package"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:1090
msgid ""
"To sign a package marking for sponsorship, it is possible to use<command>"
msgstr ""

# type: Content of: <book><chapter><sect1><screen><command><option>
#: pbuilder-doc.xml:1091 pbuilder-doc.xml:1096
msgid "--auto-debsign"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:1091
msgid "</command> and <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><screen><command><option>
#: pbuilder-doc.xml:1092 pbuilder-doc.xml:1096
msgid "--debsign-k"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1092
msgid "</command> options of <command>pdebuild</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1100
msgid "Why is there a source.changes file in ../?"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1102
msgid ""
"When running <command>pdebuild</command>, <command>pbuilder</command> will "
"run dpkg-buildpackage to create a Debian source package to pass it on to "
"<command>pbuilder</command>.  File named XXXX_YYY_source.changes is what "
"remains from that process.  It is harmless unless you try to upload it to "
"the Debian archive."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1108
msgid "This behaviour is different when running through"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1112
msgid "amd64 and i386-mode"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:1114
msgid ""
"amd64 architectures are capable of running binaries in i386 mode.  It is "
"possible to use <command>pbuilder</command> to run packages, using "
"<command>linux32</command> and <command>debootstrap"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:1117
msgid "--arch"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1117
msgid ""
"</command> option.  Specifically, a command-line option like the following "
"will work."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1130
msgid "How to use ccache"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1132
msgid ""
"To use <command>ccache</command> with <command>pbuilder</command>, use the "
"following for configuration.  Note that the directory used for CCACHE_DIR "
"needs to exist, and be writable by user within <command>chroot</command>.  "
"The default user within <command>chroot</command> is"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:1136
#, no-wrap
msgid "uid=1234"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1136 pbuilder-doc.xml:1156
msgid "."
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:1139
#, no-wrap
msgid ""
"export CCACHE_DIR=\"/var/cache/pbuilder/ccache\"\n"
"export PATH=\"/usr/lib/ccache:${PATH}\"\n"
"\n"
"EXTRAPACKAGES=ccache\n"
"BINDMOUNTS=\"${CCACHE_DIR}\""
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1151
msgid "Using tmpfs for buildplace"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1153
msgid ""
"To improve speed of operation, it is possible to use tmpfs for pbuilder "
"build location.  Mount tmpfs to <filename>/var/cache/pbuilder/build</"
"filename>, and set"
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:1163
msgid "Troubleshooting and development"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1165
msgid "Reporting bugs"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command>
#: pbuilder-doc.xml:1167
msgid ""
"To report bugs, it would be important to have a log of what's going wrong.  "
"Most of the time, adding a <command>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:1169
msgid "--debug"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1169
msgid ""
"</command> option and re-running the session should do the trick.  Please "
"send the log of such session along with your problem to ease the debugging "
"process."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1176
msgid "Mailing list"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1178
msgid ""
"There is a mailing list for <command>pbuilder</command> on alioth (pbuilder-"
"maint@lists.alioth.debian.org).  You can subscribe through the alioth web "
"interface.  <ulink url=\"http://alioth.debian.org/mail/?group_id=30778\"> "
"http://alioth.debian.org/mail/?group_id=30778</ulink>."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1186
msgid "IRC Channel"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1188
msgid ""
"For coordination and communication, IRC channel #pbuilder on irc.oftc.net is "
"used.  Please log your intent there when you are going to start doing some "
"changes and committing some change."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1195
msgid "Information for pbuilder developers"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1197
msgid ""
"This section tries to document current development practices and how things "
"generally operate in development."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1201
msgid ""
"<command>pbuilder</command> is co-maintained with resources provided by "
"Alioth.  There is an Alioth project page at <ulink url=\"http://alioth."
"debian.org/projects/pbuilder\"> http://alioth.debian.org/projects/pbuilder</"
"ulink>.  Home page is also available, at <ulink url=\"http://pbuilder.alioth."
"debian.org/\"> http://alioth.debian.org/projects/pbuilder</ulink> which "
"shows this text.  git repository is available through http, git, or (if you "
"have an account on alioth, ) ssh."
msgstr ""

# type: Content of: <book><chapter><sect1><screen>
#: pbuilder-doc.xml:1215
#, no-wrap
msgid ""
"git-clone git://git.debian.org/git/pbuilder/pbuilder.git\n"
"git-clone http://git.debian.org/git/pbuilder/pbuilder.git\n"
"git-clone ssh://git.debian.org/git/pbuilder/pbuilder.git"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1220
msgid ""
"Test-suites are available in <filename>./testsuite/</filename> directory.  "
"Changes are expected not to break the test-suites.  <filename>./run-test.sh</"
"filename> is a basic test-suite, which puts a summary in <filename>run-test."
"log</filename>, and <filename>run-test-cdebootstrap.log</filename>.  "
"<filename>./run-test-regression.sh</filename> is a regression test-suite, "
"which puts the result in <filename>run-test-regression.log</filename>.  "
"Currently, run-test.sh is ran automatically daily to ensure that pbuilder is "
"working."
msgstr ""

# type: Content of: <book><chapter><sect1><table><title>
#: pbuilder-doc.xml:1229
msgid "Directory structure of the testsuite"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><thead><row><entry>
#: pbuilder-doc.xml:1235 pbuilder-doc.xml:1495 pbuilder-doc.xml:1559
msgid "Directory"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><thead><row><entry>
#: pbuilder-doc.xml:1236 pbuilder-doc.xml:1496 pbuilder-doc.xml:1560
msgid "Meaning"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1242
msgid "Directory for testsuite"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1246
msgid ""
"Daily regression test to test against Debian Archive changes breaking "
"pbuilder."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1250
msgid "A summary of testsuite"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1254
msgid "Directory for testsuite results of running pbuilder with debootstrap"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1258
msgid "Directory for testsuite results of running pbuilder with cdebootstrap"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1262
msgid ""
"Regression testsuite, ran every time change is made to pbuilder to make sure "
"there is no regression."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1266
msgid "Summary of test result"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1270
msgid "Regression tests, exit 0 for success, exit 1 for failure"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1274
msgid "Files used for the regression testsuite."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1278
msgid ""
"Output of the regression test, output from the script is redirected by run-"
"regression.sh"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote>
#: pbuilder-doc.xml:1284
msgid ""
"When making changes, a description of the change targeted at developers "
"should be documented in <filename>ChangeLog</filename><footnote>"
msgstr ""

# type: Content of: <book><chapter><sect1><para><footnote><para>
#: pbuilder-doc.xml:1287
msgid "ChangeLog is edited using emacs ChangeLog mode."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1288
msgid ""
"</footnote>, and committed.  A brief summary of the change targeting end "
"users should be documented in <filename>debian/changelog</filename>, so that "
"users can see them.  It is important to note that the description of "
"<filename>debian/changelog</filename> is targeted at users, and "
"<filename>ChangeLog</filename> is targeted at developers.  For git commit "
"messages, a cut-n-paste of <filename>ChangeLog</filename> diff should be "
"enough."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1301
msgid ""
"A TODO file is available in <filename>debian/TODO</filename>.  It's mostly "
"not well-maintained, but hopefully it will be more up-to-date when people "
"start using it.  emacs todoo-mode is used in editing the file."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1307
msgid ""
"When releasing a new version of <command>pbuilder</command>, the version is "
"tagged with the git tag X.XXX (version number).  This is done with "
"<command>./git-tag.sh</command> script available in the source tree."
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:1315
msgid "Other uses of pbuilder"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1317
msgid "Using pbuilder for small experiments"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1319
msgid ""
"There are cases when some small experimenting is required, and you do not "
"want to damage the main system, like when installing experimental library "
"packages, or compiling with experimental compilers.  For such cases, the "
"<command>pbuilder login</command> command is available."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1326
msgid ""
"<command>pbuilder login </command> is a debugging feature for "
"<command>pbuilder</command> itself, but it also allows users to have a "
"temporary chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1330
msgid ""
"Note that the chroot is cleaned after logging out of the shell, and mounting "
"file systems inside it is considered harmful."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1335
msgid "Running little programs inside the chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1337
msgid ""
"To facilitate using <command>pbuilder</command> for other uses, "
"<command>pbuilder execute</command> is available.  <command>pbuilder execute "
"</command> will take a script specified in the command-line argument, and "
"invoke the script inside the chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1344
msgid ""
"The script can be useful for sequences of operations such as installing ssh "
"and adding a new user inside the chroot."
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:1350
msgid "Experimental or wish-list features of pbuilder"
msgstr ""

# type: Content of: <book><chapter><para>
#: pbuilder-doc.xml:1352
msgid ""
"There are some advanced features, above that of the basic feature of "
"<command>pbuilder</command>, for some specific purposes."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1356
msgid "Using LVM"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1358
msgid ""
"LVM2 has a useful snapshot function that features Copy-on-write images.  "
"That could be used for <command>pbuilder</command> just as it can be used "
"for the user-mode-linux <command>pbuilder</command> port.  It may prove to "
"be faster, but it is not implemented yet, and so no measurement has been "
"made, yet."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1365
msgid ""
"<command>User-mode-linux</command> cow support has been preferred for "
"<command>pbuilder-user-mode-linux</command>, but the idea of using LVM is "
"interesting."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1371
msgid "Using cowdancer"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1373
msgid ""
"<command>cowdancer</command> allows copy-on-write semantics on file system "
"using hard links and hard-link-breaking-on-write tricks.  <command>pbuilder</"
"command> using <command>cowdancer</command> seems to be much faster and it "
"is one ideal point for improvement.  <command>cowbuilder</command>, a "
"wrapper for <command>pbuilder</command> for using <command>cowdancer</"
"command> is available from <command>cowdancer</command> package since 0.14"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1384
msgid "Example command-lines for cowbuilder look like the following."
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:1388
#, no-wrap
msgid ""
"# cowbuilder --create --distribution sid\n"
"# cowbuilder --update --distribution sid\n"
"# cowbuilder --build XXX.dsc"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1394
msgid ""
"It is also possible to use cowdancer with pdebuild command.  Specify with "
"command-line option"
msgstr ""

# type: Content of: <book><chapter><sect1><para><option>
#: pbuilder-doc.xml:1395
msgid "--pbuilder"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1396
msgid "or set it in PDEBUILD_PBUILDER configuration option."
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:1400
#, no-wrap
msgid "$ pdebuild --pbuilder cowbuilder"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><title>
#: pbuilder-doc.xml:1404
msgid "Using cowdancer for sarge"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1406
msgid ""
"This section is mostly obsolete now that etch is released, but left for "
"reference, and will be removed after lenny release."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1411
msgid ""
"cowdancer was introduced after the release of Debian sarge; if you want to "
"build packages for sarge with cowbuilder, you will need to workaround its "
"unavailability."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1416
msgid ""
"One way to workaround the problem is to set APTCONFDIR in pbuilderrc to "
"point to a directory with a list of sources for APT which has both sarge and "
"sarge-backports."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para><screen>
#: pbuilder-doc.xml:1422
#, no-wrap
msgid ""
"$ cat sources.list\n"
"# sarge-backports\n"
"deb     http://www.backports.org/debian sarge-backports main\n"
"deb-src http://www.backports.org/debian sarge-backports main\n"
"\n"
"# sarge\n"
"deb     http://ftp.de.debian.org/debian sarge main\n"
"deb-src http://ftp.de.debian.org/debian sarge main"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1433
msgid ""
"It is recommended to \"Pin\" the cowdancer package appropriately in this "
"case, via the APT preferences mechanism."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para><screen>
#: pbuilder-doc.xml:1438
#, no-wrap
msgid ""
"$ cat preferences\n"
"Explanation: use cowdancer from backports\n"
"Package: cowdancer\n"
"Pin: release a=sarge-backports\n"
"Pin-Priority: 950"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1448
msgid "Using pbuilder without tar.gz"
msgstr ""

# type: Content of: <book><chapter><sect1><para><command><option>
#: pbuilder-doc.xml:1450
msgid "--no-targz"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1450
msgid ""
"</command> option of <command>pbuilder</command> will allow usage of "
"<command>pbuilder</command> in a different way from conventional usage.  It "
"will try to use an existing chroot, and will not try to clean up after "
"working on it.  It is an operation mode more like <command>sbuild</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1461
msgid ""
"It should be possible to create chroot images for <command>dchroot</command> "
"with the following commands:"
msgstr ""

# type: Content of: <book><chapter><sect1><para><screen>
#: pbuilder-doc.xml:1464
#, no-wrap
msgid ""
"# pbuilder create --distribution etch --no-targz --basetgz /chroot/etch\n"
"# pbuilder create --distribution lenny --no-targz --basetgz /chroot/lenny\n"
"# pbuilder create --distribution sid --no-targz --basetgz /chroot/sid"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1471
msgid "Using pbuilder in a vserver"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1473
msgid ""
"It is possible to use <command>pbuilder</command> in a vserver environment.  "
"This requires either vserver-patches in version 2.1.1-rc14 or higher, or a "
"Linux kernel version 2.6.16 or higher."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1478
msgid ""
"To use <command>pbuilder</command> in a vserver, you need to set the "
"<command>secure_mount</command> <command>CAPS</command> in the "
"<command>ccapabilities</command> of this vserver."
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:1485
msgid "Reference materials"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1487
msgid "Directory structure outside the chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><table><title>
#: pbuilder-doc.xml:1489
msgid "Directory Structure outside the chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1502
msgid "configuration file"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1506
msgid "Default configuration"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1510
msgid ""
"Default location pbuilder uses for base.tgz, the tar-ball containing a basic "
"Debian installation with only the build-essential packages."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1516
msgid "Default location pbuilder uses for chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1520
msgid ""
"Default location <command>pbuilder</command> will use as apt cache, to store "
"deb packages required during <command>pbuilder</command> build."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1524
msgid ""
"Default location <command>pbuilder</command> puts the deb files and other "
"files created after build"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1528
msgid ""
"Default location <command>pbuilder-user-mode-linux</command> puts the deb "
"files and other files created after build"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1532
msgid ""
"Default location <command>pbuilder-user-mode-linux</command> uses for "
"mounting the COW file system, for chrooting."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1536
msgid "<command>pbuilder-user-mode-linux</command> will mount tmpfs for work."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1540
msgid ""
"<command>pbuilder-user-mode-linux</command> use this directory for location "
"of COW file system."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1544
msgid ""
"<command>pbuilder-user-mode-linux</command> use this directory for user-mode-"
"linux full disk image."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1551
msgid "Directory structure inside the chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><table><title>
#: pbuilder-doc.xml:1553
msgid "Directory Structure inside the chroot"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1567
msgid "symlink to <filename>/proc/mounts</filename>."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1572
msgid ""
"Default place used in <command>pbuilder</command> to place the Debian "
"package to be processed.  <filename>/tmp/buildd/packagename-version/</"
"filename> will be the root directory of the package being processed.  HOME "
"environment variable is set to this value inside chroot by pbuilder-"
"buildpackage"
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1582
msgid ""
"The script passwd as an argument to <command>pbuilder</command> execute is "
"passed on."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1589
msgid "The location of hooks."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1595
msgid ""
"<command>pbuilder</command> copies the content of this directory to and from "
"the aptcache directory of outside chroot."
msgstr ""

# type: Content of: <book><chapter><sect1><table><tgroup><tbody><row><entry>
#: pbuilder-doc.xml:1601
msgid ""
"<command>pbuilder-user-mode-linux</command> uses a script in <filename>/tmp</"
"filename> to bootstrap into user-mode-linux"
msgstr ""

# type: Content of: <book><chapter><title>
#: pbuilder-doc.xml:1611
msgid "Minor archaeological details"
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1613
msgid "Documentation history"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1615
msgid ""
"This document was started on 28 Dec 2002 by Junichi Uekawa, trying to "
"document what is known about <command>pbuilder</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1620
msgid ""
"This documentation is available from the <command>pbuilder</command> source "
"tar-ball, and from the git repository of <command>pbuilder</command> (web-"
"based access is possible).  A copy of this documentation can be found on the "
"<ulink url=\"http://pbuilder.alioth.debian.org/pbuilder-doc.html\">Alioth "
"project page for pbuilder</ulink>.  <ulink url=\"http://pbuilder.alioth."
"debian.org/pbuilder-doc.pdf\">There is also a PDF version</ulink>.  The "
"homepage for <command>pbuilder</command> is <ulink url=\"http://www.netfort."
"gr.jp/~dancer/software/pbuilder.html\"> http://www.netfort.gr.jp/~dancer/"
"software/pbuilder.html </ulink> The project has moved its hosting to alioth "
"project since 4 Sep 2005.  It is available <ulink url=\"http://pbuilder."
"alioth.debian.org/\"> http://pbuilder.alioth.debian.org/ </ulink>"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1636
msgid ""
"Documentation is written using DocBook XML, with emacs PSGML mode, and using "
"wysidocbookxml for live previewing."
msgstr ""

# type: Content of: <book><chapter><sect1><title>
#: pbuilder-doc.xml:1642
msgid "Possibly inaccurate Background History of pbuilder"
msgstr ""

# type: Content of: <book><chapter><sect1><para>
#: pbuilder-doc.xml:1644
msgid ""
"The following is a most possibly inaccurate account of how "
"<command>pbuilder</command> came to happen, and other attempts to make "
"something like <command>pbuilder</command> happen.  This part of the "
"document was originally in the AUTHORS file, to give credit to those who "
"existed before <command>pbuilder</command>."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><title>
#: pbuilder-doc.xml:1651
msgid "The Time Before pbuilder"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1653
msgid ""
"There was once dbuild, which was a shell script to build Debian packages "
"from source. Lars Wirzenius wrote that script, and it was good, short, and "
"simple (probably).  There was nothing like build-depends then (I think), and "
"it was simple.  It could have been improved, I could only find references "
"and no actual source."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1660
msgid ""
"debbuild was probably written by James Troup. I don't know it because I have "
"never seen the actual code, I could only find some references to it on the "
"net, and mailing list logs."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1665
msgid ""
"sbuild is a perl script to build Debian packages from source.  It parses "
"Build-Depends, and performs other miscellaneous checks, and has a lot of "
"hacks to actually get things building, including a table of what package to "
"use when virtual packages are specified (does it do that still?).  It "
"supports the use of a local database for packages which do not have build-"
"dependencies. It was written by Ronan Hodek, and I think it was patched and "
"fixed and extended by several people. It is part of wanna-build, and used "
"extensively in the Debian buildd system. I think it was maintained mostly by "
"Ryan Murray."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><title>
#: pbuilder-doc.xml:1679
msgid "Birth of pbuilder"
msgstr "pbuilder の誕生"

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1681
msgid ""
"wanna-build (sbuild) was (at the time of year 2001) quite difficult to set "
"up, and it was never a Debian package. dbuild was something that predated "
"Build-Depends."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1686
msgid ""
"Building packages from source using Build-Depends information within a "
"chroot sounded trivial; and <command>pbuilder</command> was born. It was "
"initially a shell script with only a few lines, which called debootstrap and "
"chroot and dpkg-buildpackage in the same run, but soon, it was decided that "
"that's too slow."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1694
msgid ""
"Yes, and it took almost an year to get things somewhat right, and in the "
"middle of the process, Debian 3.0 was released. Yay.  Debian 3.0 wasn't "
"completely buildable with <command>pbuilder</command>, but the amount of "
"packages which are not buildable is steadily decreasing. (I hope)"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><title>
#: pbuilder-doc.xml:1703
msgid "And the second year of its life"
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1705
msgid ""
"Someone wanted <command>pbuilder</command> to not run as root, and as User-"
"mode-linux has become more useful as time passed, I've started experimenting "
"with <command>pbuilder-user-mode-linux</command>.  <command>pbuilder-user-"
"mode-linux</command> has not stayed functional as much as I would have "
"liked, and bootstrapping <command>user-mode-linux</command> environment has "
"been pretty hard, due to the quality of user-mode-linux code or packaging at "
"that time, which kept on breaking network support in one way or the other."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><title>
#: pbuilder-doc.xml:1718
msgid "Fifth year of pbuilder"
msgstr "pbuilder の5年目"

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1720
msgid ""
"<command>pbuilder</command> is now widely adopted as a 'almost standard' "
"tool for testing packages, and building packages in a pristine environment.  "
"There are other similar tools that do similar tasks, but they do not share "
"the exact same goal.  To commemorate this fact, <command>pbuilder</command> "
"is now co-maintained with several people."
msgstr ""

# type: Content of: <book><chapter><sect1><sect2><para>
#: pbuilder-doc.xml:1728
msgid ""
"<command>sbuild</command> is now a well-maintained Debian package within "
"Debian, and with <command>pbuilder</command> being such a slow monster, some "
"people prefer the approach of sbuild.  Development to use LVM-snapshots, "
"cowloop, or cowdancer is hoped to improve the situation somewhat."
msgstr ""