Sun Jul 31 08:48:23 2011 UTC ()
/pub/NetBSD/packages/ on ftp.NetBSD.org is deprecated and not writable


(spz)
diff -r1.10457 -r1.10458 pkgsrc/doc/TODO
diff -r1.61 -r1.62 pkgsrc/doc/guide/files/build.xml
diff -r1.8 -r1.9 pkgsrc/doc/guide/files/bulk.xml
diff -r1.38 -r1.39 pkgsrc/doc/guide/files/configuring.xml
diff -r1.47 -r1.48 pkgsrc/doc/guide/files/faq.xml
diff -r1.24 -r1.25 pkgsrc/doc/guide/files/introduction.xml

cvs diff -r1.10457 -r1.10458 pkgsrc/doc/TODO (expand / switch to unified diff)

--- pkgsrc/doc/TODO 2011/07/30 12:38:30 1.10457
+++ pkgsrc/doc/TODO 2011/07/31 08:48:22 1.10458
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1$NetBSD: TODO,v 1.10457 2011/07/30 12:38:30 ryoon Exp $ 1$NetBSD: TODO,v 1.10458 2011/07/31 08:48:22 spz Exp $
2 2
3Suggested new packages 3Suggested new packages
4====================== 4======================
5 5
6 any unresolved PRs (if you have commit access) 6 any unresolved PRs (if you have commit access)
7 http://www.netbsd.org/Gnats/category/pkg.html 7 http://www.netbsd.org/Gnats/category/pkg.html
8 8
9 any complete, polished packages in pkgsrc-wip (ditto) 9 any complete, polished packages in pkgsrc-wip (ditto)
10 http://pkgsrc-wip.sourceforge.net/ 10 http://pkgsrc-wip.sourceforge.net/
11 11
12 bacula-rescue 12 bacula-rescue
13 Scripts used to help create rescue boot cd's for bare metal 13 Scripts used to help create rescue boot cd's for bare metal
14 restores with bacula. Scripts exist for linux, solaris, and 14 restores with bacula. Scripts exist for linux, solaris, and
@@ -1530,28 +1530,28 @@ Suggested pkgsrc enhancements @@ -1530,28 +1530,28 @@ Suggested pkgsrc enhancements
1530 o Make "pkg_install -u" clear the unsafe_depends* and rebuild 1530 o Make "pkg_install -u" clear the unsafe_depends* and rebuild
1531 tags, and set unsafe_depends* on depending packages, 1531 tags, and set unsafe_depends* on depending packages,
1532 following the behavior of make replace. 1532 following the behavior of make replace.
1533 1533
1534 o Figure out a way to have "pkg_install -u", probably with a 1534 o Figure out a way to have "pkg_install -u", probably with a
1535 flag, preserve the value of the automatic tag. We do not 1535 flag, preserve the value of the automatic tag. We do not
1536 have consensus on the right behavior. 1536 have consensus on the right behavior.
1537 1537
1538Suggested other platform enhancements 1538Suggested other platform enhancements
1539===================================== 1539=====================================
1540 1540
1541 o platform independent bulk build infrastructure 1541 o platform independent bulk build infrastructure
1542 1542
1543 o update the binary bootstrap kits on 1543 o update the binary bootstrap kits in
1544 ftp://ftp.netbsd.org/pub/NetBSD/packages/bootstrap-pkgsrc/ 1544 ftp.NetBSD.org:/pub/pkgsrc/packages/OS/arch/version-branch/
1545 1545
1546Suggested cleanups in pkgsrc 1546Suggested cleanups in pkgsrc
1547============================ 1547============================
1548 1548
1549 o Make packages install their configuration files under the 1549 o Make packages install their configuration files under the
1550 examples hierarchy, using bsd.pkg.install.mk to copy them 1550 examples hierarchy, using bsd.pkg.install.mk to copy them
1551 to the PKG_SYSCONFDIR directory when necessary. 1551 to the PKG_SYSCONFDIR directory when necessary.
1552 1552
1553 o Make packages install honour PKGLOCALEDIR by setting 1553 o Make packages install honour PKGLOCALEDIR by setting
1554 USE_PKGLOCALEDIR=YES where appropriate (for eg. Solaris). 1554 USE_PKGLOCALEDIR=YES where appropriate (for eg. Solaris).
1555 Affects: cross/h8300-hms-binutils, cross/h8300-hms-gcc, 1555 Affects: cross/h8300-hms-binutils, cross/h8300-hms-gcc,
1556 cross/i386-netbsdpe, sysutils/apcupsd, sysutils/gnometoaster, 1556 cross/i386-netbsdpe, sysutils/apcupsd, sysutils/gnometoaster,
1557 sysutils/mtoolsfm, sysutils/xnc 1557 sysutils/mtoolsfm, sysutils/xnc

cvs diff -r1.61 -r1.62 pkgsrc/doc/guide/files/build.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/build.xml 2009/08/02 02:41:53 1.61
+++ pkgsrc/doc/guide/files/build.xml 2011/07/31 08:48:22 1.62
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: build.xml,v 1.61 2009/08/02 02:41:53 joerg Exp $ --> 1<!-- $NetBSD: build.xml,v 1.62 2011/07/31 08:48:22 spz Exp $ -->
2 2
3<chapter id="build"> 3<chapter id="build">
4 <title>The build process</title> 4 <title>The build process</title>
5 5
6 <sect1 id="build.intro"> 6 <sect1 id="build.intro">
7 <title>Introduction</title> 7 <title>Introduction</title>
8 8
9 <para>This chapter gives a detailed description on how a package is 9 <para>This chapter gives a detailed description on how a package is
10 built. Building a package is separated into different 10 built. Building a package is separated into different
11 <emphasis>phases</emphasis> (for example <varname>fetch</varname>, 11 <emphasis>phases</emphasis> (for example <varname>fetch</varname>,
12 <varname>build</varname>, <varname>install</varname>), all of which are 12 <varname>build</varname>, <varname>install</varname>), all of which are
13 described in the following sections. Each phase is split into 13 described in the following sections. Each phase is split into
14 so-called <emphasis>stages</emphasis>, which take the name of the 14 so-called <emphasis>stages</emphasis>, which take the name of the
@@ -329,30 +329,30 @@ ${MASTER_SITE_PGSQL} @@ -329,30 +329,30 @@ ${MASTER_SITE_PGSQL}
329${MASTER_SITE_R_CRAN} 329${MASTER_SITE_R_CRAN}
330${MASTER_SITE_SOURCEFORGE} 330${MASTER_SITE_SOURCEFORGE}
331${MASTER_SITE_SOURCEFORGE_JP} 331${MASTER_SITE_SOURCEFORGE_JP}
332${MASTER_SITE_SUNSITE} 332${MASTER_SITE_SUNSITE}
333${MASTER_SITE_SUSE} 333${MASTER_SITE_SUSE}
334${MASTER_SITE_TEX_CTAN} 334${MASTER_SITE_TEX_CTAN}
335${MASTER_SITE_XCONTRIB} 335${MASTER_SITE_XCONTRIB}
336${MASTER_SITE_XEMACS} 336${MASTER_SITE_XEMACS}
337</programlisting> 337</programlisting>
338 338
339 <para>Some explanations for the less self-explaining ones: 339 <para>Some explanations for the less self-explaining ones:
340 <varname>MASTER_SITE_BACKUP</varname> contains backup sites 340 <varname>MASTER_SITE_BACKUP</varname> contains backup sites
341 for packages that are maintained in <ulink 341 for packages that are maintained in <ulink
342 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}" 342 url="ftp://ftp.NetBSD.org/pkgsrc/distfiles/${DIST_SUBDIR}"
343 />. <varname>MASTER_SITE_LOCAL</varname> contains local 343 />. <varname>MASTER_SITE_LOCAL</varname> contains local
344 package source distributions that are maintained in <ulink 344 package source distributions that are maintained in <ulink
345 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/LOCAL_PORTS/" 345 url="ftp://ftp.NetBSD.org/pub/pkgsrc/distfiles/LOCAL_PORTS/"
346 />.</para> 346 />.</para>
347 347
348 <para>If you choose one of these predefined sites, you may 348 <para>If you choose one of these predefined sites, you may
349 want to specify a subdirectory of that site. Since these 349 want to specify a subdirectory of that site. Since these
350 macros may expand to more than one actual site, you 350 macros may expand to more than one actual site, you
351 <emphasis>must</emphasis> use the following construct to 351 <emphasis>must</emphasis> use the following construct to
352 specify a subdirectory:</para> 352 specify a subdirectory:</para>
353 353
354<programlisting> 354<programlisting>
355MASTER_SITES= ${MASTER_SITE_GNU:=subdirectory/name/} 355MASTER_SITES= ${MASTER_SITE_GNU:=subdirectory/name/}
356MASTER_SITES= ${MASTER_SITE_SOURCEFORGE:=project_name/} 356MASTER_SITES= ${MASTER_SITE_SOURCEFORGE:=project_name/}
357</programlisting> 357</programlisting>
358 358

cvs diff -r1.8 -r1.9 pkgsrc/doc/guide/files/bulk.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/bulk.xml 2010/03/18 10:56:18 1.8
+++ pkgsrc/doc/guide/files/bulk.xml 2011/07/31 08:48:22 1.9
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: bulk.xml,v 1.8 2010/03/18 10:56:18 wiz Exp $ --> 1<!-- $NetBSD: bulk.xml,v 1.9 2011/07/31 08:48:22 spz Exp $ -->
2 2
3<chapter id="bulk"> 3<chapter id="bulk">
4<title>Creating binary packages for everything in pkgsrc (bulk 4<title>Creating binary packages for everything in pkgsrc (bulk
5builds)</title> 5builds)</title>
6 6
7<para>When you have multiple machines that should run the same packages, 7<para>When you have multiple machines that should run the same packages,
8it is wasted time if they all build their packages themselves from 8it is wasted time if they all build their packages themselves from
9source. There are two ways of getting a set of binary packages: The old 9source. There are two ways of getting a set of binary packages: The old
10bulk build system, or the new (as of 2007) parallel bulk build (pbulk) 10bulk build system, or the new (as of 2007) parallel bulk build (pbulk)
11system. This chapter describes how to set them up so that the packages 11system. This chapter describes how to set them up so that the packages
12are most likely to be usable later.</para> 12are most likely to be usable later.</para>
13 13
14<sect1 id="bulk.pre"> 14<sect1 id="bulk.pre">
@@ -518,62 +518,57 @@ fi @@ -518,62 +518,57 @@ fi
518 <varname>MKSUMS=yes</varname> in your 518 <varname>MKSUMS=yes</varname> in your
519 <filename>mk/bulk/build.conf</filename>.</para> 519 <filename>mk/bulk/build.conf</filename>.</para>
520 520
521 <para>If you would like to PGP sign the checksum files (highly 521 <para>If you would like to PGP sign the checksum files (highly
522 recommended!), remember to set 522 recommended!), remember to set
523 <varname>SIGN_AS=username@NetBSD.org</varname> in your 523 <varname>SIGN_AS=username@NetBSD.org</varname> in your
524 <filename>mk/bulk/build.conf</filename>. This will prompt you for 524 <filename>mk/bulk/build.conf</filename>. This will prompt you for
525 your GPG password to sign the files before uploading everything.</para> 525 your GPG password to sign the files before uploading everything.</para>
526 526
527 <para>Then, make sure that you have <varname>RSYNC_DST</varname> 527 <para>Then, make sure that you have <varname>RSYNC_DST</varname>
528 set properly in your <filename>mk/bulk/build.conf</filename> 528 set properly in your <filename>mk/bulk/build.conf</filename>
529 file, i.e. adjust it to something like one of the following:</para> 529 file, i.e. adjust it to something like one of the following:</para>
530 530
531 <screen>RSYNC_DST=ftp.NetBSD.org:/pub/NetBSD/packages/packages-20xxQy/NetBSD-a.b.c/arch/upload </screen> 531 <screen>RSYNC_DST=ftp.NetBSD.org:/pub/pkgsrc/packages/NetBSD/arch/a.b.c-20xxQy/upload</screen>
532 532
533 <para>Please use appropriate values for "packages-20xxQy", 533 <para>Please use appropriate values for "20xxQy" (the branch),
534 "NetBSD-a.b.c" and "arch" here. If your login on ftp.NetBSD.org 534 "a.b.c" (the OS version) and "arch" here. If your login on ftp.NetBSD.org
535 is different from your local login, write your login directly 535 is different from your local login, write your login directly
536 into the variable, e.g. my local account is "feyrer", but for my 536 into the variable, e.g. my local account is "feyrer", but for my
537 login "hubertf", I use:</para> 537 login "hubertf", I use:</para>
538 538
539 <screen>RSYNC_DST=hubertf@ftp.NetBSD.org:/pub/NetBSD/packages/packages-20xxQy/NetBSD-a.b.c/arch/upload</screen> 539 <screen>RSYNC_DST=hubertf@ftp.NetBSD.org:/pub/pkgsrc/packages/NetBSD/arch/a.b.c-20xxQy/upload</screen>
540 540
541 <para>A separate <filename>upload</filename> directory is used 541 <para>A separate <filename>upload</filename> directory is used
542 here to allow "closing" the directory during upload. To do 542 here to allow "closing" the directory during upload. To do
543 so, run the following command on ftp.NetBSD.org next:</para> 543 so, run the following command on ftp.NetBSD.org next:</para>
544 544
545 <screen>nbftp% <userinput>mkdir -p -m 750 /pub/NetBSD/packages/packages-20xxQy/NetBSD-a.b.c/arch/upload</userinput></screen> 545 <screen>nbftp% <userinput>mkdir -p -m 750 /pub/pkgsrc/packages/NetBSD/arch/a.b.c-20xxQy/upload</userinput></screen>
546 
547 <para>Please note that <filename>/pub/NetBSD/packages</filename> is 
548 only appropriate for packages for the NetBSD operating 
549 system. Binary packages for other operating systems should go 
550 into <filename>/pub/pkgsrc</filename>.</para> 
551 546
552 <para>Before uploading the binary pkgs, ssh authentication needs 547 <para>Before uploading the binary pkgs, ssh authentication needs
553 to be set up. This example shows how to set up temporary keys 548 to be set up. This example shows how to set up temporary keys
554 for the root account <emphasis>inside the sandbox</emphasis> 549 for the root account <emphasis>inside the sandbox</emphasis>
555 (assuming that no keys should be present there usually):</para> 550 (assuming that no keys should be present there usually):</para>
556 551
557 <screen> 552 <screen>
558&rprompt; <userinput>chroot /usr/sandbox</userinput> 553&rprompt; <userinput>chroot /usr/sandbox</userinput>
559chroot-&rprompt; <userinput>rm $HOME/.ssh/id-dsa*</userinput> 554chroot-&rprompt; <userinput>rm $HOME/.ssh/id-dsa*</userinput>
560chroot-&rprompt; <userinput>ssh-keygen -t dsa</userinput> 555chroot-&rprompt; <userinput>ssh-keygen -t rsa</userinput>
561chroot-&rprompt; <userinput>cat $HOME/.ssh/id-dsa.pub</userinput> 556chroot-&rprompt; <userinput>cat $HOME/.ssh/id-rsa.pub</userinput>
562 </screen> 557 </screen>
563 558
564 <para>Now take the output of <filename>id-dsa.pub</filename> and 559 <para>Now take the output of <filename>id-rsa.pub</filename> and
565 append it to your <filename>~/.ssh/authorized_keys</filename> 560 append it to your <filename>~/.ssh/authorized_keys</filename>
566 file on ftp.NetBSD.org. You can remove the key after the 561 file on ftp.NetBSD.org. You should remove the key after the
567 upload is done!</para> 562 upload is done!</para>
568 563
569 <para>Next, test if your ssh connection really works:</para> 564 <para>Next, test if your ssh connection really works:</para>
570 565
571 <screen>chroot-&rprompt; <userinput>ssh ftp.NetBSD.org date</userinput> </screen> 566 <screen>chroot-&rprompt; <userinput>ssh ftp.NetBSD.org date</userinput> </screen>
572 567
573 <para>Use "-l yourNetBSDlogin" here as appropriate!</para> 568 <para>Use "-l yourNetBSDlogin" here as appropriate!</para>
574 569
575 <para>Now after all this works, you can exit the sandbox and start 570 <para>Now after all this works, you can exit the sandbox and start
576 the upload:</para> 571 the upload:</para>
577 572
578 <screen> 573 <screen>
579chroot-&rprompt; <userinput>exit</userinput> 574chroot-&rprompt; <userinput>exit</userinput>
@@ -587,30 +582,31 @@ chroot-&rprompt; exit @@ -587,30 +582,31 @@ chroot-&rprompt; exit
587 restricted packages.</para> 582 restricted packages.</para>
588 583
589 <para>After the upload has ended, first thing is to revoke ssh access:</para> 584 <para>After the upload has ended, first thing is to revoke ssh access:</para>
590 585
591 <screen>nbftp% <userinput>vi ~/.ssh/authorized_keys</userinput> 586 <screen>nbftp% <userinput>vi ~/.ssh/authorized_keys</userinput>
592 Gdd:x! </screen> 587 Gdd:x! </screen>
593 588
594 <para>Use whatever is needed to remove the key you've entered 589 <para>Use whatever is needed to remove the key you've entered
595 before! Last, move the uploaded packages out of the 590 before! Last, move the uploaded packages out of the
596 <filename>upload</filename> directory to have them accessible 591 <filename>upload</filename> directory to have them accessible
597 to everyone:</para> 592 to everyone:</para>
598 593
599 <screen> 594 <screen>
600nbftp% <userinput>cd /pub/NetBSD/packages/packages-20xxQy/NetBSD-a.b.c/arch</userinput> 595nbftp% <userinput>cd /pub/pkgsrc/packages/NetBSD/arch/a.b.c-20xxQy</userinput>
601nbftp% <userinput>mv upload/* .</userinput> 596nbftp% <userinput>mv upload/* .</userinput>
602nbftp% <userinput>rmdir upload</userinput> 597nbftp% <userinput>rmdir upload</userinput>
603nbftp% <userinput>chmod 755 .</userinput> 598nbftp% <userinput>chgrp -R netbsd .</userinput>
 599nbftp% <userinput>find . -type d | xargs chmod 775</userinput>
604 </screen> 600 </screen>
605 601
606<!-- end old --> 602<!-- end old -->
607</sect2> 603</sect2>
608 604
609</sect1> 605</sect1>
610 606
611<sect1 id="bulk.pbulk"> 607<sect1 id="bulk.pbulk">
612<title>Running a pbulk-style bulk build</title> 608<title>Running a pbulk-style bulk build</title>
613 609
614<para>Running a pbulk-style bulk build works roughly as follows:</para> 610<para>Running a pbulk-style bulk build works roughly as follows:</para>
615 611
616<itemizedlist> 612<itemizedlist>

cvs diff -r1.38 -r1.39 pkgsrc/doc/guide/files/configuring.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/configuring.xml 2011/04/09 08:03:49 1.38
+++ pkgsrc/doc/guide/files/configuring.xml 2011/07/31 08:48:22 1.39
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: configuring.xml,v 1.38 2011/04/09 08:03:49 wiz Exp $ --> 1<!-- $NetBSD: configuring.xml,v 1.39 2011/07/31 08:48:22 spz Exp $ -->
2 2
3<chapter id="configuring"> 3<chapter id="configuring">
4 <title>Configuring pkgsrc</title> 4 <title>Configuring pkgsrc</title>
5 5
6<anchor id="mk.conf" /> 6<anchor id="mk.conf" />
7 7
8<para>The whole pkgsrc system is configured in a single file, usually 8<para>The whole pkgsrc system is configured in a single file, usually
9called <filename>mk.conf</filename>. In which directory pkgsrc looks for 9called <filename>mk.conf</filename>. In which directory pkgsrc looks for
10that file depends on the installation. On NetBSD, when you use 10that file depends on the installation. On NetBSD, when you use
11&man.make.1; from the base system, it is in the directory 11&man.make.1; from the base system, it is in the directory
12<filename>/etc/</filename>. In all other cases the default location is 12<filename>/etc/</filename>. In all other cases the default location is
13<literal>${PREFIX}/etc/</literal>, depending on where you told the 13<literal>${PREFIX}/etc/</literal>, depending on where you told the
14bootstrap program to install the binary packages.</para> 14bootstrap program to install the binary packages.</para>
@@ -58,27 +58,27 @@ works. @@ -58,27 +58,27 @@ works.
58 database about installed packages is stored. The default is 58 database about installed packages is stored. The default is
59 <filename>/var/db/pkg</filename>.</para> 59 <filename>/var/db/pkg</filename>.</para>
60 </listitem> 60 </listitem>
61 <listitem><para><varname>MASTER_SITE_OVERRIDE</varname>: 61 <listitem><para><varname>MASTER_SITE_OVERRIDE</varname>:
62 If set, override the packages' 62 If set, override the packages'
63 <varname>MASTER_SITES</varname> with this value.</para> 63 <varname>MASTER_SITES</varname> with this value.</para>
64 </listitem> 64 </listitem>
65 <listitem><para><varname>MASTER_SITE_BACKUP</varname>: 65 <listitem><para><varname>MASTER_SITE_BACKUP</varname>:
66 Backup location(s) for distribution files and patch files 66 Backup location(s) for distribution files and patch files
67 if not found locally or in 67 if not found locally or in
68 <filename>${MASTER_SITES}</filename> or 68 <filename>${MASTER_SITES}</filename> or
69 <filename>${PATCH_SITES}</filename> respectively. 69 <filename>${PATCH_SITES}</filename> respectively.
70 The defaults are 70 The defaults are
71 <filename>ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/${DIST_SUBDIR}/</filename> 71 <filename>ftp://ftp.NetBSD.org/pub/pkgsrc/distfiles/${DIST_SUBDIR}/</filename>
72 and 72 and
73 <filename>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/${DIST_SUBDIR}/</filename>.</para> 73 <filename>ftp://ftp.freebsd.org/pub/FreeBSD/distfiles/${DIST_SUBDIR}/</filename>.</para>
74 </listitem> 74 </listitem>
75 <listitem><para><varname>BINPKG_SITES</varname>: 75 <listitem><para><varname>BINPKG_SITES</varname>:
76 List of sites carrying binary pkgs. <replaceable>rel</replaceable> and 76 List of sites carrying binary pkgs. <replaceable>rel</replaceable> and
77 <replaceable>arch</replaceable> are replaced with OS 77 <replaceable>arch</replaceable> are replaced with OS
78 release (<quote>2.0</quote>, etc.) and architecture 78 release (<quote>2.0</quote>, etc.) and architecture
79 (<quote>mipsel</quote>, etc.).</para> 79 (<quote>mipsel</quote>, etc.).</para>
80 </listitem> 80 </listitem>
81 <listitem><para><varname>ACCEPTABLE_LICENSES</varname>: 81 <listitem><para><varname>ACCEPTABLE_LICENSES</varname>:
82 List of acceptable licenses. License names are case-sensitive. 82 List of acceptable licenses. License names are case-sensitive.
83 Whenever you try to build a package whose license is not in this 83 Whenever you try to build a package whose license is not in this
84 list, you will get an error message. If the license condition is 84 list, you will get an error message. If the license condition is

cvs diff -r1.47 -r1.48 pkgsrc/doc/guide/files/faq.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/faq.xml 2010/12/23 23:54:17 1.47
+++ pkgsrc/doc/guide/files/faq.xml 2011/07/31 08:48:22 1.48
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: faq.xml,v 1.47 2010/12/23 23:54:17 abs Exp $ --> 1<!-- $NetBSD: faq.xml,v 1.48 2011/07/31 08:48:22 spz Exp $ -->
2 2
3<chapter id="faq"> <?dbhtml filename="faq.html"?> 3<chapter id="faq"> <?dbhtml filename="faq.html"?>
4<title>Frequently Asked Questions</title> 4<title>Frequently Asked Questions</title>
5 5
6<para>This section contains hints, tips &amp; tricks on special things in 6<para>This section contains hints, tips &amp; tricks on special things in
7pkgsrc that we didn't find a better place for in the previous chapters, and 7pkgsrc that we didn't find a better place for in the previous chapters, and
8it contains items for both pkgsrc users and developers.</para> 8it contains items for both pkgsrc users and developers.</para>
9 9
10<!-- ================================================================== --> 10<!-- ================================================================== -->
11 11
12 <sect1 id="mailing-list-pointers"> 12 <sect1 id="mailing-list-pointers">
13 <title>Are there any mailing lists for pkg-related discussion?</title> 13 <title>Are there any mailing lists for pkg-related discussion?</title>
14 14
@@ -359,27 +359,27 @@ refuses to do passive. For the other to @@ -359,27 +359,27 @@ refuses to do passive. For the other to
359<filename>/usr/bin/ftp</filename> from falling back to active 359<filename>/usr/bin/ftp</filename> from falling back to active
360transfers.</para> 360transfers.</para>
361 361
362</sect1> 362</sect1>
363 363
364<!-- ================================================================== --> 364<!-- ================================================================== -->
365 365
366<sect1 id="fetching-all-distfiles"> 366<sect1 id="fetching-all-distfiles">
367<title>How to fetch all distfiles at once</title> 367<title>How to fetch all distfiles at once</title>
368 368
369<para>You would like to download all the distfiles in a single batch 369<para>You would like to download all the distfiles in a single batch
370from work or university, where you can't run a <command>make 370from work or university, where you can't run a <command>make
371fetch</command>. There is an archive of distfiles on <ulink 371fetch</command>. There is an archive of distfiles on <ulink
372url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/">ftp.NetBSD.org</ulink>, 372url="ftp://ftp.NetBSD.org/pub/pkgsrc/distfiles/">ftp.NetBSD.org</ulink>,
373but downloading the entire directory may not be appropriate.</para> 373but downloading the entire directory may not be appropriate.</para>
374 374
375<para>The answer here is to do a <command>make fetch-list</command> in 375<para>The answer here is to do a <command>make fetch-list</command> in
376<filename>/usr/pkgsrc</filename> or one of its subdirectories, carry the 376<filename>/usr/pkgsrc</filename> or one of its subdirectories, carry the
377resulting list to your machine at work/school and use it there. If you 377resulting list to your machine at work/school and use it there. If you
378don't have a NetBSD-compatible &man.ftp.1; (like tnftp) at work, don't 378don't have a NetBSD-compatible &man.ftp.1; (like tnftp) at work, don't
379forget to set <varname>FETCH_CMD</varname> to something that fetches a 379forget to set <varname>FETCH_CMD</varname> to something that fetches a
380URL:</para> 380URL:</para>
381 381
382<para>At home:</para> 382<para>At home:</para>
383 383
384<screen>&cprompt; <userinput>cd /usr/pkgsrc</userinput> 384<screen>&cprompt; <userinput>cd /usr/pkgsrc</userinput>
385&cprompt; <userinput>make fetch-list FETCH_CMD=wget DISTDIR=/tmp/distfiles >/tmp/fetch.sh</userinput> 385&cprompt; <userinput>make fetch-list FETCH_CMD=wget DISTDIR=/tmp/distfiles >/tmp/fetch.sh</userinput>
@@ -507,31 +507,31 @@ reinstall any affected packages. @@ -507,31 +507,31 @@ reinstall any affected packages.
507and some of these bugs can leave a machine vulnerable to exploitation by 507and some of these bugs can leave a machine vulnerable to exploitation by
508attackers. In an effort to lessen the exposure, the NetBSD packages team 508attackers. In an effort to lessen the exposure, the NetBSD packages team
509maintains a database of known-exploits to packages which have at one time 509maintains a database of known-exploits to packages which have at one time
510been included in pkgsrc. The database can be downloaded automatically, and 510been included in pkgsrc. The database can be downloaded automatically, and
511a security audit of all packages installed on a system can take place. To 511a security audit of all packages installed on a system can take place. To
512do this, refer to the following two tools (installed as part of the 512do this, refer to the following two tools (installed as part of the
513<filename role="pkg">pkgtools/pkg_install</filename> package):</para> 513<filename role="pkg">pkgtools/pkg_install</filename> package):</para>
514 514
515<orderedlist> 515<orderedlist>
516 516
517 <listitem> 517 <listitem>
518 <para><command>pkg_admin fetch-pkg-vulnerabilities</command>, an easy way to 518 <para><command>pkg_admin fetch-pkg-vulnerabilities</command>, an easy way to
519 download a list of the security vulnerabilities information. This list 519 download a list of the security vulnerabilities information. This list
520 is kept up to date by the NetBSD security officer and the NetBSD 520 is kept up to date by the pkgsrc security team, and is distributed
521 packages team, and is distributed from the NetBSD ftp server:</para> 521 from the NetBSD ftp server:</para>
522 522
523 <para><ulink 523 <para><ulink
524 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/distfiles/pkg-vulnerabilities"/></para> 524 url="ftp://ftp.NetBSD.org/pkgsrc/distfiles/pkg-vulnerabilities"/></para>
525 </listitem> 525 </listitem>
526 526
527 <listitem> 527 <listitem>
528 <para><command>pkg_admin audit</command>, an easy way to audit the 528 <para><command>pkg_admin audit</command>, an easy way to audit the
529 current machine, checking each known vulnerability. If a 529 current machine, checking each known vulnerability. If a
530 vulnerable package is installed, it will be shown by output to stdout, 530 vulnerable package is installed, it will be shown by output to stdout,
531 including a description of the type of vulnerability, and a URL 531 including a description of the type of vulnerability, and a URL
532 containing more information.</para> 532 containing more information.</para>
533 </listitem> 533 </listitem>
534 534
535</orderedlist> 535</orderedlist>
536 536
537<para>Use of these tools is strongly recommended! After 537<para>Use of these tools is strongly recommended! After

cvs diff -r1.24 -r1.25 pkgsrc/doc/guide/files/introduction.xml (expand / switch to unified diff)

--- pkgsrc/doc/guide/files/introduction.xml 2011/04/09 19:09:45 1.24
+++ pkgsrc/doc/guide/files/introduction.xml 2011/07/31 08:48:22 1.25
@@ -1,14 +1,14 @@ @@ -1,14 +1,14 @@
1<!-- $NetBSD: introduction.xml,v 1.24 2011/04/09 19:09:45 wiz Exp $ --> 1<!-- $NetBSD: introduction.xml,v 1.25 2011/07/31 08:48:22 spz Exp $ -->
2 2
3<chapter id="introduction"> 3<chapter id="introduction">
4 <title>What is pkgsrc?</title> 4 <title>What is pkgsrc?</title>
5 5
6 <sect1 id="introduction-section"> 6 <sect1 id="introduction-section">
7 <title>Introduction</title> 7 <title>Introduction</title>
8 8
9<para>There is a lot of software freely available for Unix-based 9<para>There is a lot of software freely available for Unix-based
10systems, which is usually available in form of the source code. Before 10systems, which is usually available in form of the source code. Before
11such software can be used, it needs to be configured to the local 11such software can be used, it needs to be configured to the local
12system, compiled and installed, and this is exactly what The NetBSD 12system, compiled and installed, and this is exactly what The NetBSD
13Packages Collection (pkgsrc) does. pkgsrc also has some basic commands 13Packages Collection (pkgsrc) does. pkgsrc also has some basic commands
14to handle binary packages, so that not every user has to build the 14to handle binary packages, so that not every user has to build the
@@ -281,27 +281,27 @@ minutes! @@ -281,27 +281,27 @@ minutes!
281 </varlistentry> 281 </varlistentry>
282 282
283 <varlistentry> 283 <varlistentry>
284 <term>Precompiled/binary package</term> 284 <term>Precompiled/binary package</term>
285 285
286 <listitem> 286 <listitem>
287 <para>A set of binaries built with pkgsrc from a distfile 287 <para>A set of binaries built with pkgsrc from a distfile
288 and stuffed together in a single <filename>.tgz</filename> 288 and stuffed together in a single <filename>.tgz</filename>
289 file so it can be installed on machines of the same 289 file so it can be installed on machines of the same
290 machine architecture without the need to 290 machine architecture without the need to
291 recompile. Packages are usually generated in 291 recompile. Packages are usually generated in
292 <filename>/usr/pkgsrc/packages</filename>; there is also 292 <filename>/usr/pkgsrc/packages</filename>; there is also
293 an archive on <ulink 293 an archive on <ulink
294 url="ftp://ftp.NetBSD.org/pub/NetBSD/packages/">ftp.NetBSD.org</ulink>.</para> 294 url="ftp://ftp.NetBSD.org/pub/pkgsrc/packages/">ftp.NetBSD.org</ulink>.</para>
295 295
296 <para>Sometimes, this is referred to by the term <quote>package</quote> too, 296 <para>Sometimes, this is referred to by the term <quote>package</quote> too,
297 especially in the context of precompiled packages.</para> 297 especially in the context of precompiled packages.</para>
298 </listitem> 298 </listitem>
299 </varlistentry> 299 </varlistentry>
300 300
301 <varlistentry> 301 <varlistentry>
302 <term>Program</term> 302 <term>Program</term>
303 303
304 <listitem> 304 <listitem>
305 <para>The piece of software to be installed which will be 305 <para>The piece of software to be installed which will be
306 constructed from all the files in the distfile by the 306 constructed from all the files in the distfile by the
307 actions defined in the corresponding package.</para> 307 actions defined in the corresponding package.</para>