mirror of
https://github.com/fspc/dswim.git
synced 2026-09-16 08:31:39 -04:00
*** empty log message ***
This commit is contained in:
freesource
@@ -0,0 +1,26 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - DESCRIPTION
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 1<br>
|
||||
DESCRIPTION
|
||||
|
||||
</h1>
|
||||
|
||||
<kbd>swimrc</kbd> is the configuartion file for swim allowing many
|
||||
default values to be set so that they do not have to be mentioned on the
|
||||
command line. Swimrc interacts directly with Perl allowing a wide variety
|
||||
of variables found in <kbd>SWIW::Conf</kbd> to be altered.
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-usage.html">next</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,26 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - FILES
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 5<br>
|
||||
FILES
|
||||
|
||||
</h1>
|
||||
|
||||
<code> /etc/swim/swimrc</code><P>
|
||||
|
||||
<code>~/.swim/swimrc</code>
|
||||
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch6.html">next</A>; <A href="ch-othervars.html">back</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,23 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - OTHER VARIABLES
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 4<br>
|
||||
OTHER VARIABLES
|
||||
|
||||
</h1>
|
||||
|
||||
see SWIM::Conf
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-files.html">next</A>; <A href="ch-variables.html">back</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,35 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - RESTRICTIONS
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 6<br>
|
||||
RESTRICTIONS
|
||||
|
||||
</h1>
|
||||
|
||||
Strange Situations: If the same package happens to exist in two different
|
||||
sections, <em>main and non-us</em> for example, and you make the
|
||||
databases, you will still be able to find this package in the non-us
|
||||
group, but its section and locations will be the one which main recognizes
|
||||
assuming that you use the order in the example below.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
Example: You just want to pull out main and contrib every time you run
|
||||
<code>--initndb</code>, <code>--rebuildndb</code>, or <code>--ndb</code>.
|
||||
<P>
|
||||
<code>@user_defined_section</code> = <code>``qw(main contrib non-US)'';</code>
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-files.html">back</A>.
|
||||
<br>
|
||||
<address>14 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,29 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - USAGE
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 2<br>
|
||||
USAGE
|
||||
|
||||
</h1>
|
||||
Values for variable can be altered for <strong>swim</strong> by assigning
|
||||
different values enclosed in quotes or quoted whitespace (qw()), and ending
|
||||
with a semi-colon. <P>
|
||||
|
||||
<code> $variable = ``value'';</code><P>
|
||||
<code>$variable = ``(value1 value2 ..)'';</code>
|
||||
<P>
|
||||
<P>
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-variables.html">next</A>; <A href="ch-description.html">back</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,284 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - VARIABLES
|
||||
</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 3<br>
|
||||
VARIABLES
|
||||
|
||||
</h1>
|
||||
This is a list of variables with explanations. The default values for
|
||||
<strong>swim</strong> are shown.
|
||||
|
||||
|
||||
<hr>
|
||||
<h2><A name="s3.1">
|
||||
3.1 OUTPUT VARIABLE
|
||||
|
||||
</A></h2>
|
||||
<code>$my_number</code> can be changed to how many lines you would like
|
||||
``swim -qf <>'' to print out, before the program asks for
|
||||
<code>-t</code> or <code>--total</code>. Exception: If <code>-i</code> is
|
||||
used in the query and there is more than one package then the total will
|
||||
be presented.
|
||||
|
||||
<P>
|
||||
|
||||
Hint: <code>-t</code> can be used with all the various
|
||||
<code>--scripts</code> family members to view the title of the script file
|
||||
regardless of this variable setting, and if <code>-t</code> has to be
|
||||
used, the titles will be displayed, which makes sense.
|
||||
|
||||
<P>
|
||||
|
||||
<strong>$my_number = 23;</strong>
|
||||
|
||||
<hr>
|
||||
<h2><A name="s3.2">
|
||||
3.2 HISTORY
|
||||
|
||||
</A></h2>
|
||||
|
||||
This is a shell-like history kept in relation to searches and the most
|
||||
recent edit when <code>--stdin</code> is used.
|
||||
<P>
|
||||
|
||||
<strong>$HISTORY = 10;</strong>
|
||||
|
||||
<hr>
|
||||
<h2><A name="s3.3">
|
||||
3.3 AR or DPKG?
|
||||
|
||||
</A></h2>
|
||||
|
||||
Debian packages are ar archives. If you are using a Debian Distribution
|
||||
assign ``dpkg'' to $package_tool, otherwise assign ``ar'' to
|
||||
$package_tool.
|
||||
<P>
|
||||
|
||||
<strong>$package_tool = "/usr/bin/ar";</strong>
|
||||
<hr>
|
||||
<h2><A name="s3.4">
|
||||
3.4 APT
|
||||
|
||||
</A></h2>
|
||||
|
||||
<strong>Swim</strong> does not assign a value for apt. To use
|
||||
<code>--apt</code> and <code>-xyz</code> assign <code>$apt</code> the
|
||||
value ``yes''.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
Example: <strong>$apt = "yes";</strong>
|
||||
<hr>
|
||||
<h2><A name="s3.5">
|
||||
3.5 PAGER
|
||||
|
||||
</A></h2>
|
||||
|
||||
|
||||
<strong>less</strong> is a nice pager, unless you like
|
||||
<strong>more</strong>! Pager is used for <code>--help</code> and
|
||||
<strong>swim</strong> called without any options. There is an option
|
||||
<code>--nopager</code> or <code>-n</code>. <strong>more</strong> comes from the
|
||||
required package util-linux, whereas <strong>less</strong> comes from a
|
||||
standard package called less. Values: ``less'', ``more'', or ``most''
|
||||
or...
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$ENV{PAGER} = "less";</strong>
|
||||
<hr>
|
||||
<h2><A name="s3.6">
|
||||
3.6 NOT-INSTALLED VARIABLES
|
||||
|
||||
</A></h2>
|
||||
|
||||
Assign values for <code>$architecture</code> and/or
|
||||
<code>$distribution</code> to avoid having to use <code>--arch</code> and
|
||||
<code>--dists</code> everytime the not-installed databases are accessed
|
||||
with <code>-n</code> or made or altered.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
Architectures are always being added so check with Debian to find a list.
|
||||
There is <em>alpha, arm, hurd-i386 (alternative kernel to linux), i386,
|
||||
m68k, powerpc, sparc</em>. Just use the arch found after the hyphen in the
|
||||
Contents-(arch) file.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$architecture = "i386";</strong>
|
||||
<P>
|
||||
|
||||
|
||||
The distribution can be either <em>stable, unstable, frozen, or
|
||||
experimental (rare)</em>. These represent the state of development that
|
||||
the packages are under. The unstable distribution can have lot's of
|
||||
changes within a very short time period, and frozen may or may not be
|
||||
available.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$distribution = "unstable";</strong>
|
||||
<P>
|
||||
|
||||
|
||||
Distributions are divided into sections. These sections were called
|
||||
distributions in the version 2.4.1.0 packaging manual, because they were
|
||||
at
|
||||
one time separate distributions, but this has since changed.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
You can determine which of the sections <em>main, non-free, contrib or
|
||||
non-US</em> to pull out of the Contents file if you don't want to use
|
||||
<code>--main</code>, <code>--contrib</code>, <code>--non-free</code>, and
|
||||
<code>--non-us</code> to selectively pick the sections.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
For efficiency, you should choose the sections which you will be pulling
|
||||
out of the Packages <code>file(s)</code> being targetted.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
Rule: Use ``non-US'' not ``non-us''.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>@user_defined_section = qw(main contrib non-free non-US);</strong>
|
||||
|
||||
<hr>
|
||||
<h2><A name="s3.7">
|
||||
3.7 DF LOCATION
|
||||
|
||||
</A></h2>
|
||||
|
||||
A little philosophy: <strong>swim</strong> was developed for maximum
|
||||
versatility, so whether you are just interested in researching, and
|
||||
keeping tabs on the newest packages, or maintaining a Debian virtual
|
||||
distribution on a non-Debian distribution, or you are a using
|
||||
<strong>swim</strong> for distribution development, <strong>swim</strong>
|
||||
provides a way.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
The next two variables determine the location of the DF (default
|
||||
directory/file system)
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
The default directory keeps track of Contents and/or Packages databases
|
||||
retrieved with --ftp. The Contents and Packages databases and Release file
|
||||
are give names specific to the distribution and architectures they
|
||||
represent using the naming convention found in apt's sources directory.
|
||||
You also have the freedom not to use the default directory, in which case
|
||||
swim
|
||||
|
||||
will still do the renaming and keeping track of the mtime, but you will
|
||||
have to remember where you put the files.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$default_directory = '/root/.swim';</strong>
|
||||
|
||||
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
The default root directory (DRD) is the key to easy management of binary
|
||||
packages, source, dsc, and diff files received from --ftp, and provides an
|
||||
easy way to put together a personalized distribution. This directory can
|
||||
be
|
||||
a real ftp site on your computer, or put wherever else you are allowed to
|
||||
have directories. The DRD is always placed below the value assigned to
|
||||
$default_directory. According to the previous assignment to
|
||||
$default_directory, if the DRD is ``/pub/a/debian'' then the full path
|
||||
would be ``/root/.swim/pub/a/debian''.
|
||||
<P>
|
||||
|
||||
|
||||
Example: When a package is downloaded it will be placed in
|
||||
dists/distribution/section/architecture/subject below the DRD.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
Rule: debian must be the final directory before dists, this is because
|
||||
other distributions are placed alongside debian, like debian-non-US or
|
||||
personal (specialized distribution).
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$default_root_directory = '/pub/debian';</strong>
|
||||
<P>
|
||||
|
||||
|
||||
Because you may be using a real ftp site, this variable allows you to
|
||||
determine what permissions <strong>swim</strong> will assign for
|
||||
directories it
|
||||
creates below the DRD.
|
||||
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$permission = '0755';</strong>
|
||||
|
||||
<hr>
|
||||
<h2><A name="s3.8">
|
||||
3.8 TEMPORARY DIRECTORY
|
||||
|
||||
</A></h2>
|
||||
If you want to set an alternative directory for the temporary files
|
||||
created when the databases are made, change here. You may want to make
|
||||
<code>$tmp</code> a RAM disk. See package loadlin for initrd documentation and
|
||||
an explanation for making such a disk. There is also documentation in
|
||||
/usr/src/kernel-source.version/Documentation. Whether this will speed
|
||||
things up is a subject of experimentation.
|
||||
<P>
|
||||
|
||||
|
||||
<strong>$tmp = "/tmp";</strong>
|
||||
<hr>
|
||||
<h2><A name="s3.9">
|
||||
3.9 FTP
|
||||
|
||||
</A></h2>
|
||||
|
||||
You can alter the Firewall, Port, Timeout, Debug and Passive
|
||||
characteristics of the ftp client as defined in Net::FTP(3pm) by providing
|
||||
arguments to these variables. All variables but $timeout are set to untrue
|
||||
by default.
|
||||
|
||||
<pre> $firewall = 0; (FTP firewall machine name)
|
||||
$port = 0; (defaults to 23)
|
||||
$timeout = 120; (120 seconds)
|
||||
$debug = 0; (1 will turn on STDERR)
|
||||
$passive = 0; (1 will enable)</pre>
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-othervars.html">next</A>; <A href="ch-usage.html">back</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,20 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file - BUGS</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>
|
||||
swimrc - swim configuration file - chapter 6<br>
|
||||
BUGS
|
||||
</h1>
|
||||
Send directly to mttrader@access.mountain.net.
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="index.html#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="index.html#toc">Contents</A>; <A href="ch-files.html">back</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
@@ -0,0 +1,76 @@
|
||||
<html><head>
|
||||
<title>swimrc - swim configuration file</title>
|
||||
<link rev=made href="mailto:mttrader@access.mountain.net">
|
||||
</head><body>
|
||||
<h1>swimrc - swim configuration file</h1>
|
||||
|
||||
<h2><A name="toc">
|
||||
0.1 Table of contents
|
||||
</A></h2>
|
||||
<ul>
|
||||
<li><A href="ch-description.html">1 DESCRIPTION
|
||||
</A>
|
||||
<li><A href="ch-usage.html">2 USAGE
|
||||
</A>
|
||||
<li><A href="ch-variables.html">3 VARIABLES
|
||||
</A>
|
||||
<ul>
|
||||
<li><A href="ch-variables.html#s3.1">3.1</A> OUTPUT VARIABLE
|
||||
|
||||
<li><A href="ch-variables.html#s3.2">3.2</A> HISTORY
|
||||
|
||||
<li><A href="ch-variables.html#s3.3">3.3</A> AR or DPKG?
|
||||
|
||||
<li><A href="ch-variables.html#s3.4">3.4</A> APT
|
||||
|
||||
<li><A href="ch-variables.html#s3.5">3.5</A> PAGER
|
||||
|
||||
<li><A href="ch-variables.html#s3.6">3.6</A> NOT-INSTALLED VARIABLES
|
||||
|
||||
<li><A href="ch-variables.html#s3.7">3.7</A> DF LOCATION
|
||||
|
||||
<li><A href="ch-variables.html#s3.8">3.8</A> TEMPORARY DIRECTORY
|
||||
|
||||
<li><A href="ch-variables.html#s3.9">3.9</A> FTP
|
||||
|
||||
</ul>
|
||||
<li><A href="ch-othervars.html">4 OTHER VARIABLES
|
||||
</A>
|
||||
<li><A href="ch-files.html">5 FILES
|
||||
</A>
|
||||
<li><A href="ch6.html">6 BUGS</A>
|
||||
</ul>
|
||||
<hr><h2><A name="copyright">0.2 Copyright</A></h2>
|
||||
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
<P>
|
||||
|
||||
SWIM, including this manual, is free software; you
|
||||
may redistribute it and/or modify it under the terms of the
|
||||
GNU General Public License as published by the Free Software
|
||||
Foundation; either version 2, or (at your option) any later
|
||||
version.
|
||||
<P>
|
||||
|
||||
This is distributed in the hope that it will be useful, but
|
||||
<em>without any warranty</em>; without even the implied
|
||||
warranty of merchantability or fitness for a particular
|
||||
purpose. See the GNU General Public License for more
|
||||
details.
|
||||
<P>
|
||||
|
||||
You should have received a copy of the GNU General Public
|
||||
License with the <kbd>swim</kbd> source as the file
|
||||
<code>COPYING</code>. If not, write to the Free Software
|
||||
Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
||||
<hr>
|
||||
swimrc - swim configuration file
|
||||
- <A href="#copyright">
|
||||
Copyright © 1999 Jonathan D. Rosenbaum
|
||||
</A>
|
||||
<br>
|
||||
<A href="#toc">Contents</A>.
|
||||
<br>
|
||||
<address>27 May 1999<br>
|
||||
Jonathan D. Rosenbaum<A href="mailto:mttrader@access.mountain.net">mttrader@access.mountain.net</A></address>
|
||||
</body></html>
|
||||
Reference in New Issue
Block a user