aboutsummaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorSatoshi Asami <asami@FreeBSD.org>1997-10-08 10:16:01 +0000
committerSatoshi Asami <asami@FreeBSD.org>1997-10-08 10:16:01 +0000
commit7b320196b04939d74706892483bdf97f0f41fc3b (patch)
tree1faffb7a73e5adfad538afda2f733f957a9f3064
parent9c5607dd07c17738c6091bfd813592382023a58f (diff)
downloaddoc-7b320196b04939d74706892483bdf97f0f41fc3b.tar.gz
doc-7b320196b04939d74706892483bdf97f0f41fc3b.zip
(1) Add "pkg_delete; make reinstall; make package" to the list of
things to do while testing. This is to make sure obsolete files do not remain in pkg/PLIST. (2) Add small section about auto-generating master.passwd entries. List currently used UIDs. (3) While I'm here, update the tcl shared library version number (was 7.3) in the example. ;)
Notes
Notes: svn path=/head/; revision=2039
-rw-r--r--handbook/porting.sgml46
1 files changed, 40 insertions, 6 deletions
diff --git a/handbook/porting.sgml b/handbook/porting.sgml
index 10affea61c..cbecbfee6f 100644
--- a/handbook/porting.sgml
+++ b/handbook/porting.sgml
@@ -1,4 +1,4 @@
-<!-- $Id: porting.sgml,v 1.78 1997-09-22 19:23:46 max Exp $ -->
+<!-- $Id: porting.sgml,v 1.79 1997-10-08 10:16:01 asami Exp $ -->
<!-- The FreeBSD Documentation Project -->
<sect1><heading>Porting an existing piece of free software<label id="porting"></heading>
@@ -293,10 +293,14 @@ lib/X11/oneko/mouse.xpm
<p>You should make sure that the port rules do exactly what
you want it to do, including packaging up the port. Try
doing `<tt>make install</tt>', `<tt>make package</tt>' and
- then `<tt>pkg_delete -d &lt;pkgname&gt;</tt>' and see if all
- the files are correctly deleted. Then do a `<tt>pkg_add
- &lt;pkgname&gt;.tgz</tt>' and see if everything re-appears
- and works correctly.
+ then `<tt>pkg_delete &lt;pkgname&gt;</tt>' and see if all
+ the files and directories are correctly deleted. Then do a
+ `<tt>pkg_add &lt;pkgname&gt;.tgz</tt>' and see if everything
+ re-appears and works correctly. Then do another
+ `<tt>pkg_delete &lt;pkgname&gt;</tt>' and then `<tt>make
+ reinstall; make package</tt>' to make sure you haven't
+ included in the packing list any files that are not
+ installed by your port.
<sect3>
<heading>Submitting the port<label id="porting:submitting"></heading>
@@ -1469,7 +1473,7 @@ MAN8= baz.8
immediately follow the line for the shared library itself,
as in:
<tscreen><verb>
-lib/libtcl.so.7.3
+lib/libtcl80.so.1.0
@exec /sbin/ldconfig -m %D/lib
</verb></tscreen>
@@ -1485,6 +1489,36 @@ lib/libtcl.so.7.3
necessarily in that order)....
<sect3>
+ <heading>UIDs</heading>
+
+ <p>If your port requires a certain user ID to be on the
+ installed system, let the <tt>pkg/INSTALL</tt> script call
+ <tt>pw</tt> to create it automatically. Look at
+ <tt>japanese/Wnn</tt> or <tt>net/cvsup-mirror</tt> for
+ examples. It is customary to use UIDs in the upper 2-digit
+ range (i.e., from around 50 to 99) for this purpose.
+
+ <p>Make sure you don't use a UID already used by the system or
+ other ports. This is the current list of UIDs between 50
+ and 99.
+
+<tscreen><verb>
+majordom:*:54:1024:Majordomo Pseudo User:/usr/local/majordomo:/nonexistent
+cyrus:*:60:248:the cyrus mail server:/nonexistent:/nonexistent
+uucp:*:66:66:UUCP pseudo-user:/var/spool/uucppublic:/usr/libexec/uucp/uucico
+xten:*:67:67:X-10 daemon:/usr/local/xten:/nonexistent
+pop:*:68:6:Post Office Owner:/nonexistent:/nonexistent
+wnn:*:69:7:Wnn:/nonexistent:/nonexistent
+pgsql:*:71:246:PostgreSQL pseudo-user:/usr/local/pgsql:/bin/sh
+msql:*:80:249:mSQL-2 pseudo-user:/var/db/msqldb:/bin/sh
+</verb></tscreen>
+
+ <p>Please send a notice to <htmlurl
+ url='mailto:ports@FreeBSD.org' name='ports@FreeBSD.org'> if
+ you submit or commit a port that allocates a new UID in this
+ range so we can keep this list up to date.
+
+ <sect3>
<heading>If you are stuck....</heading>
<p>Do look at existing examples and the <tt>bsd.port.mk</tt>