Package created for version 0.2.1

This commit is contained in:
KatolaZ 2017-01-07 23:47:32 +00:00
parent 3fbc818cca
commit 2991262656
50 changed files with 5201 additions and 3 deletions

View File

@ -0,0 +1,11 @@
2017-01-07 KatolaZ <katolaz@freaknet.org>
* setnet.sh (configure_device): Improved wifi detection
* (netdiag_ping), (netdiag_traceroute),(netdiag_query):
changed dialog to programbox
* solved viasualitation bug in ip config
* added a manpage
* Added configuration variable "WIFI_DEVICES"
* The "Setup interface" menu has been reorganised
* added "Config IP Address" and "Manage Wifi Networking"

View File

@ -0,0 +1,132 @@
+--------------+
| setnet |
+--------------+
Copyleft (C) Vincenzo "KatolaZ" Nicosia <katolaz@freaknet.org>
2016, 2017
=== DESCRIPTION ===
setnet is a shell script with a dialog UI to configure ethernet and
wifi connections. It is meant to be POSIX-compliant, and has been
tested with bash, busybox, dash, ksh, mksh, posh, and yash. It is
still to be considered beta software, so you should use it AT YOUR OWN
RISK, but it is already fully functional.
=== LICENSE ===
setnet is Free Software, and can be used and distributed under the
terms of the GNU General Public License, either version 3 of the
licence or, at your option, any later version.
Please see the file LICENSE for more information
=== DEPENDENCIES ===
In order to run setset, you MUST satisfy this (relatively small) set
of dependencies:
- a posix-compliant shell (bash, busybox, dash, ksh, mksh, posh, and
yash have been tested)
- dialog (version 1.2 tested, but it should work with previous
versions as well)
- dhcp-client (for dhclient, tested with isc-dhcp-client)
- iproute2 (for ip)
- wireless-tools (for iwconfig, currently required for interface
identification)
Most of those tools might already be installed in your system anyway.
In particular, setnet uses:
- dialog: to provide a minimal Text-based User Interface,
- ip: to configure network interfaces and get information about them,
- dhclient: for DHCP-based IP configuration
- iwconfig: to check whether a network device is a wifi adapter
In order to use the full set of functionalities provided by setnet,
you MIGHT also need the following packages:
- wpa_supplicant (for wifi configuration)
- net-tools (for netstat, to gather information about network status)
- iputils-ping (for ping)
- bind9-nost (for host, used to check DNS configuration)
- traceroute (to trace the route between your host and any other host
in the Internet)
Again, most of them should be already installed in your system anyway.
=== USAGE ===
setnet is installed under /usr/sbin/setnet.sh. If invoked with "-h",
it provides a list of supported options:
$ ./setnet.sh -h
Usage: setnet.sh [OPTION]
Options:
-c cfg_file Load configuration from cfg_file.
-v Print version number and exit.
-h Show this help.
$
If the argument "-c" is specified, setnet will use the provided
configuration file. Otherwise, it will look for its configuration file
in one of the following locations:
- /etc/setnetrc
- ~/.setnetrc
in the given order. The following configuration variables should be
defined in setnetrc:
- WPA_FILE
This is the file configuration file used by wpa_supplicant.
- LOGNAME
This is the file used for logging.
- TRUNCATE_LOG
if equal to "yes", the log file will be truncated when setnet
starts
=== root vs. mortal users ===
Networking is an amdinistration task, and as such should be performed
by the host administrator, i.e., the user with UID 0 (normally called
"root"). However, in many modern GNU/Linux systems it is customary to
allow normal users to perform some administration tasks. There are at
least two concrete possibilities to allow a particular user (in the
following we call such user "fool") to configure network interfaces
using setnet.
-- 1) First approach: using sudo
If sudo is installed in your system, it is sufficient to add the
following line:
fool ALL=NOPASSWD: /usr/sbin/setnet.sh
to the file /etc/sudoers, and the user "fool" will be able to run
setnet.sh with effective UID 0 (i.e., as if it was root), by using the
command:
[fool@host]$ sudo /usr/sbin/setnet.sh
and thus will be able to perform all the needed admin tasks to
configure networking.
-- 2) Second approach: using sup
......TO BE DOCUMENTED......

View File

@ -0,0 +1,10 @@
setnet for Debian
----------------
<this file describes information about the source package, see Debian policy
manual section 4.14. You WILL either need to modify or delete this file>
-- Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org> Wed, 04 Jan 2017 18:52:56 +0000

View File

@ -0,0 +1,34 @@
setnet (0.2.1-1) unstable; urgency=medium
* Version 0.2.1 -- See ChangeLog for details
-- Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org> Sat, 07 Jan 2017 23:29:44 +0000
setnet (0.2-1) unstable; urgency=medium
* Initial release (20170104)
== Major Changes ==
+ Polished code to make it posix-shell compliant
+ Tested with bash, busybox, dash, ksh, mksh, posh, yash
+ Added support and checks for hard, soft, and optional
dependencies
+ Added standard command line options (-c, -h, -v)
+ Added submenu "Info" with basic network testing tools
+ Added submenu "Dump" to dump network information to a file
+ Added submenu "Log" (shows setnet logfile)
+ Added status information in device configuration panel
+ Added minimal README.Debian file
-- Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org> Wed, 04 Jan 2017 18:52:56 +0000

View File

@ -0,0 +1 @@
9

View File

@ -0,0 +1,19 @@
Source: setnet
Section: unknown
Priority: optional
Maintainer: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
Build-Depends: debhelper (>=9)
Standards-Version: 3.9.8
Homepage: http://kalos.mine.nu/setnet
#Vcs-Git: git://anonscm.debian.org/collab-maint/setnet.git
#Vcs-Browser: https://anonscm.debian.org/cgit/collab-maint/setnet.git
Package: setnet
Architecture: all
Depends: ${shlibs:Depends}, ${misc:Depends}, bash | busybox | dash | ksh | mksh | posh | yash , dhcp-client, dialog, iproute2, iw
Suggests: wpasupplicant, pastebinit, net-tools, iputils-ping, bind9-host, traceroute
Description: simple shell/dialog tool to configure networks
setnet is a shell script with a dialog UI to configure ethernet
and wifi connections. It is meant to be POSIX-compliant, and has
been tested on bash, busybox, dash, ksh, mksh, posh, and yash.

View File

@ -0,0 +1,21 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: setnet
Source: <http://kalos.mine.nu/setnet>
Files: debian/*
Copyright: 2016 Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
License: GPL-3+
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>
.

View File

@ -0,0 +1 @@
setnet

View File

@ -0,0 +1 @@
setnet_0.2.1-1_all.deb unknown optional

View File

@ -0,0 +1,26 @@
#!/bin/sh
# kFreeBSD do not accept scripts as interpreters, using #!/bin/sh and sourcing.
if [ true != "$INIT_D_SCRIPT_SOURCED" ] ; then
set "$0" "$@"; INIT_D_SCRIPT_SOURCED=true . /lib/init/init-d-script
fi
### BEGIN INIT INFO
# Provides: setnet
# Required-Start: $remote_fs $syslog
# Required-Stop: $remote_fs $syslog
# Default-Start: 2 3 4 5
# Default-Stop: 0 1 6
# Short-Description: <Enter a short description of the software>
# Description: <Enter a long description of the software>
# <...>
# <...>
### END INIT INFO
# Author: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
DESC="setnet"
DAEMON=/usr/bin/setnet
# This is an example to start a single forking daemon capable of writing
# a pid file. To get other behaviors, implement do_start(), do_stop() or
# other functions to override the defaults in /lib/init/init-d-script.
# See also init-d-script(5)

View File

@ -0,0 +1,5 @@
setnet.sh /usr/sbin
setnetrc /etc/
wpa_setnet.conf /etc/wpa_supplicant/
setnet.8.gz /usr/share/man/man8/
ChangeLog /usr/share/doc/setnet/

View File

@ -0,0 +1,56 @@
.\" Hey, EMACS: -*- nroff -*-
.\" (C) Copyright 2017 Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>,
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH Setnet SECTION "January 4 2017"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh disable hyphenation
.\" .hy enable hyphenation
.\" .ad l left justify
.\" .ad b justify to both left and right margins
.\" .nf disable filling
.\" .fi enable filling
.\" .br insert line break
.\" .sp <n> insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH NAME
setnet \- program to do something
.SH SYNOPSIS
.B setnet
.RI [ options ] " files" ...
.br
.B bar
.RI [ options ] " files" ...
.SH DESCRIPTION
This manual page documents briefly the
.B setnet
and
.B bar
commands.
.PP
.\" TeX users may be more comfortable with the \fB<whatever>\fP and
.\" \fI<whatever>\fP escape sequences to invode bold face and italics,
.\" respectively.
\fBsetnet\fP is a program that...
.SH OPTIONS
These programs follow the usual GNU command line syntax, with long
options starting with two dashes (`-').
A summary of options is included below.
For a complete description, see the Info files.
.TP
.B \-h, \-\-help
Show summary of options.
.TP
.B \-v, \-\-version
Show version of program.
.SH SEE ALSO
.BR bar (1),
.BR baz (1).
.br
The programs are documented fully by
.IR "The Rise and Fall of a Fooish Bar" ,
available via the Info system.

View File

@ -0,0 +1,154 @@
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V4.1//EN" [
<!-- Process this file with docbook-to-man to generate an nroff manual
page: `docbook-to-man manpage.sgml > manpage.1'. You may view
the manual page with: `docbook-to-man manpage.sgml | nroff -man |
less'. A typical entry in a Makefile or Makefile.am is:
manpage.1: manpage.sgml
docbook-to-man $< > $@
The docbook-to-man binary is found in the docbook-to-man package.
Please remember that if you create the nroff version in one of the
debian/rules file targets (such as build), you will need to include
docbook-to-man in your Build-Depends control field.
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "<firstname>FIRSTNAME</firstname>">
<!ENTITY dhsurname "<surname>SURNAME</surname>">
<!-- Please adjust the date whenever revising the manpage. -->
<!ENTITY dhdate "<date>January 4 2017</date>">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1). -->
<!ENTITY dhsection "<manvolnum>SECTION</manvolnum>">
<!ENTITY dhemail "<email>katolaz@freaknet.org</email>">
<!ENTITY dhusername "Vincenzo (KatolaZ) Nicosia">
<!ENTITY dhucpackage "<refentrytitle>Setnet</refentrytitle>">
<!ENTITY dhpackage "setnet">
<!ENTITY debian "<productname>Debian</productname>">
<!ENTITY gnu "<acronym>GNU</acronym>">
<!ENTITY gpl "&gnu; <acronym>GPL</acronym>">
]>
<refentry>
<refentryinfo>
<address>
&dhemail;
</address>
<author>
&dhfirstname;
&dhsurname;
</author>
<copyright>
<year>2003</year>
<holder>&dhusername;</holder>
</copyright>
&dhdate;
</refentryinfo>
<refmeta>
&dhucpackage;
&dhsection;
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>program to do something</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<arg><option>-e <replaceable>this</replaceable></option></arg>
<arg><option>--example <replaceable>that</replaceable></option></arg>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1>
<title>DESCRIPTION</title>
<para>This manual page documents briefly the
<command>&dhpackage;</command> and <command>bar</command>
commands.</para>
<para>This manual page was written for the &debian; distribution
because the original program does not have a manual page.
Instead, it has documentation in the &gnu;
<application>Info</application> format; see below.</para>
<para><command>&dhpackage;</command> is a program that...</para>
</refsect1>
<refsect1>
<title>OPTIONS</title>
<para>These programs follow the usual &gnu; command line syntax,
with long options starting with two dashes (`-'). A summary of
options is included below. For a complete description, see the
<application>Info</application> files.</para>
<variablelist>
<varlistentry>
<term><option>-h</option>
<option>--help</option>
</term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-v</option>
<option>--version</option>
</term>
<listitem>
<para>Show version of program.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1>
<title>SEE ALSO</title>
<para>bar (1), baz (1).</para>
<para>The programs are documented fully by <citetitle>The Rise and
Fall of a Fooish Bar</citetitle> available via the
<application>Info</application> system.</para>
</refsect1>
<refsect1>
<title>AUTHOR</title>
<para>This manual page was written by &dhusername; &dhemail; for
the &debian; system (and may be used by others). Permission is
granted to copy, distribute and/or modify this document under
the terms of the &gnu; General Public License, Version 2 any
later version published by the Free Software Foundation.
</para>
<para>
On Debian systems, the complete text of the GNU General Public
License can be found in /usr/share/common-licenses/GPL.
</para>
</refsect1>
</refentry>
<!-- Keep this comment at the end of the file
Local variables:
mode: sgml
sgml-omittag:t
sgml-shorttag:t
sgml-minimize-attributes:nil
sgml-always-quote-attributes:t
sgml-indent-step:2
sgml-indent-data:t
sgml-parent-document:nil
sgml-default-dtd-file:nil
sgml-exposed-tags:nil
sgml-local-catalogs:nil
sgml-local-ecat-files:nil
End:
-->

View File

@ -0,0 +1,291 @@
<?xml version='1.0' encoding='UTF-8'?>
<!DOCTYPE refentry PUBLIC "-//OASIS//DTD DocBook XML V4.5//EN"
"http://www.oasis-open.org/docbook/xml/4.5/docbookx.dtd" [
<!--
`xsltproc -''-nonet \
-''-param man.charmap.use.subset "0" \
-''-param make.year.ranges "1" \
-''-param make.single.year.ranges "1" \
/usr/share/xml/docbook/stylesheet/docbook-xsl/manpages/docbook.xsl \
manpage.xml'
A manual page <package>.<section> will be generated. You may view the
manual page with: nroff -man <package>.<section> | less'. A typical entry
in a Makefile or Makefile.am is:
DB2MAN = /usr/share/sgml/docbook/stylesheet/xsl/docbook-xsl/manpages/docbook.xsl
XP = xsltproc -''-nonet -''-param man.charmap.use.subset "0"
manpage.1: manpage.xml
$(XP) $(DB2MAN) $<
The xsltproc binary is found in the xsltproc package. The XSL files are in
docbook-xsl. A description of the parameters you can use can be found in the
docbook-xsl-doc-* packages. Please remember that if you create the nroff
version in one of the debian/rules file targets (such as build), you will need
to include xsltproc and docbook-xsl in your Build-Depends control field.
Alternatively use the xmlto command/package. That will also automatically
pull in xsltproc and docbook-xsl.
Notes for using docbook2x: docbook2x-man does not automatically create the
AUTHOR(S) and COPYRIGHT sections. In this case, please add them manually as
<refsect1> ... </refsect1>.
To disable the automatic creation of the AUTHOR(S) and COPYRIGHT sections
read /usr/share/doc/docbook-xsl/doc/manpages/authors.html. This file can be
found in the docbook-xsl-doc-html package.
Validation can be done using: `xmllint -''-noout -''-valid manpage.xml`
General documentation about man-pages and man-page-formatting:
man(1), man(7), http://www.tldp.org/HOWTO/Man-Page/
-->
<!-- Fill in your name for FIRSTNAME and SURNAME. -->
<!ENTITY dhfirstname "FIRSTNAME">
<!ENTITY dhsurname "SURNAME">
<!-- dhusername could also be set to "&dhfirstname; &dhsurname;". -->
<!ENTITY dhusername "Vincenzo (KatolaZ) Nicosia">
<!ENTITY dhemail "katolaz@freaknet.org">
<!-- SECTION should be 1-8, maybe w/ subsection other parameters are
allowed: see man(7), man(1) and
http://www.tldp.org/HOWTO/Man-Page/q2.html. -->
<!ENTITY dhsection "SECTION">
<!-- TITLE should be something like "User commands" or similar (see
http://www.tldp.org/HOWTO/Man-Page/q2.html). -->
<!ENTITY dhtitle "setnet User Manual">
<!ENTITY dhucpackage "Setnet">
<!ENTITY dhpackage "setnet">
]>
<refentry>
<refentryinfo>
<title>&dhtitle;</title>
<productname>&dhpackage;</productname>
<authorgroup>
<author>
<firstname>&dhfirstname;</firstname>
<surname>&dhsurname;</surname>
<contrib>Wrote this manpage for the Debian system.</contrib>
<address>
<email>&dhemail;</email>
</address>
</author>
</authorgroup>
<copyright>
<year>2007</year>
<holder>&dhusername;</holder>
</copyright>
<legalnotice>
<para>This manual page was written for the Debian system
(and may be used by others).</para>
<para>Permission is granted to copy, distribute and/or modify this
document under the terms of the GNU General Public License,
Version 2 or (at your option) any later version published by
the Free Software Foundation.</para>
<para>On Debian systems, the complete text of the GNU General Public
License can be found in
<filename>/usr/share/common-licenses/GPL</filename>.</para>
</legalnotice>
</refentryinfo>
<refmeta>
<refentrytitle>&dhucpackage;</refentrytitle>
<manvolnum>&dhsection;</manvolnum>
</refmeta>
<refnamediv>
<refname>&dhpackage;</refname>
<refpurpose>program to do something</refpurpose>
</refnamediv>
<refsynopsisdiv>
<cmdsynopsis>
<command>&dhpackage;</command>
<!-- These are several examples, how syntaxes could look -->
<arg choice="plain"><option>-e <replaceable>this</replaceable></option></arg>
<arg choice="opt"><option>--example=<parameter>that</parameter></option></arg>
<arg choice="opt">
<group choice="req">
<arg choice="plain"><option>-e</option></arg>
<arg choice="plain"><option>--example</option></arg>
</group>
<replaceable class="option">this</replaceable>
</arg>
<arg choice="opt">
<group choice="req">
<arg choice="plain"><option>-e</option></arg>
<arg choice="plain"><option>--example</option></arg>
</group>
<group choice="req">
<arg choice="plain"><replaceable>this</replaceable></arg>
<arg choice="plain"><replaceable>that</replaceable></arg>
</group>
</arg>
</cmdsynopsis>
<cmdsynopsis>
<command>&dhpackage;</command>
<!-- Normally the help and version options make the programs stop
right after outputting the requested information. -->
<group choice="opt">
<arg choice="plain">
<group choice="req">
<arg choice="plain"><option>-h</option></arg>
<arg choice="plain"><option>--help</option></arg>
</group>
</arg>
<arg choice="plain">
<group choice="req">
<arg choice="plain"><option>-v</option></arg>
<arg choice="plain"><option>--version</option></arg>
</group>
</arg>
</group>
</cmdsynopsis>
</refsynopsisdiv>
<refsect1 id="description">
<title>DESCRIPTION</title>
<para>This manual page documents briefly the
<command>&dhpackage;</command> and <command>bar</command>
commands.</para>
<para>This manual page was written for the Debian distribution
because the original program does not have a manual page.
Instead, it has documentation in the GNU <citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> format; see below.</para>
<para><command>&dhpackage;</command> is a program that...</para>
</refsect1>
<refsect1 id="options">
<title>OPTIONS</title>
<para>The program follows the usual GNU command line syntax,
with long options starting with two dashes (`-'). A summary of
options is included below. For a complete description, see the
<citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> files.</para>
<variablelist>
<!-- Use the variablelist.term.separator and the
variablelist.term.break.after parameters to
control the term elements. -->
<varlistentry>
<term><option>-e <replaceable>this</replaceable></option></term>
<term><option>--example=<replaceable>that</replaceable></option></term>
<listitem>
<para>Does this and that.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-h</option></term>
<term><option>--help</option></term>
<listitem>
<para>Show summary of options.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><option>-v</option></term>
<term><option>--version</option></term>
<listitem>
<para>Show version of program.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="files">
<title>FILES</title>
<variablelist>
<varlistentry>
<term><filename>/etc/foo.conf</filename></term>
<listitem>
<para>The system-wide configuration file to control the
behaviour of <application>&dhpackage;</application>. See
<citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for further details.</para>
</listitem>
</varlistentry>
<varlistentry>
<term><filename>${HOME}/.foo.conf</filename></term>
<listitem>
<para>The per-user configuration file to control the
behaviour of <application>&dhpackage;</application>. See
<citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry> for further details.</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="environment">
<title>ENVIRONMENT</title>
<variablelist>
<varlistentry>
<term><envar>FOO_CONF</envar></term>
<listitem>
<para>If used, the defined file is used as configuration
file (see also <xref linkend="files"/>).</para>
</listitem>
</varlistentry>
</variablelist>
</refsect1>
<refsect1 id="diagnostics">
<title>DIAGNOSTICS</title>
<para>The following diagnostics may be issued
on <filename class="devicefile">stderr</filename>:</para>
<variablelist>
<varlistentry>
<term><errortext>Bad configuration file. Exiting.</errortext></term>
<listitem>
<para>The configuration file seems to contain a broken configuration
line. Use the <option>--verbose</option> option, to get more info.
</para>
</listitem>
</varlistentry>
</variablelist>
<para><command>&dhpackage;</command> provides some return codes, that can
be used in scripts:</para>
<segmentedlist>
<segtitle>Code</segtitle>
<segtitle>Diagnostic</segtitle>
<seglistitem>
<seg><errorcode>0</errorcode></seg>
<seg>Program exited successfully.</seg>
</seglistitem>
<seglistitem>
<seg><errorcode>1</errorcode></seg>
<seg>The configuration file seems to be broken.</seg>
</seglistitem>
</segmentedlist>
</refsect1>
<refsect1 id="bugs">
<!-- Or use this section to tell about upstream BTS. -->
<title>BUGS</title>
<para>The program is currently limited to only work
with the <package>foobar</package> library.</para>
<para>The upstreams <acronym>BTS</acronym> can be found
at <ulink url="http://bugzilla.foo.tld"/>.</para>
</refsect1>
<refsect1 id="see_also">
<title>SEE ALSO</title>
<!-- In alpabetical order. -->
<para><citerefentry>
<refentrytitle>bar</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>baz</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry>, <citerefentry>
<refentrytitle>foo.conf</refentrytitle>
<manvolnum>5</manvolnum>
</citerefentry></para>
<para>The programs are documented fully by <citetitle>The Rise and
Fall of a Fooish Bar</citetitle> available via the <citerefentry>
<refentrytitle>info</refentrytitle>
<manvolnum>1</manvolnum>
</citerefentry> system.</para>
</refsect1>
</refentry>

View File

@ -0,0 +1,2 @@
?package(setnet):needs="X11|text|vc|wm" section="Applications/see-menu-manual"\
title="setnet" command="/usr/bin/setnet"

View File

@ -0,0 +1,39 @@
#!/bin/sh
# postinst script for setnet
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postinst> `configure' <most-recently-configured-version>
# * <old-postinst> `abort-upgrade' <new version>
# * <conflictor's-postinst> `abort-remove' `in-favour' <package>
# <new-version>
# * <postinst> `abort-remove'
# * <deconfigured's-postinst> `abort-deconfigure' `in-favour'
# <failed-install-package> <version> `removing'
# <conflicting-package> <version>
# for details, see https://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
configure)
;;
abort-upgrade|abort-remove|abort-deconfigure)
;;
*)
echo "postinst called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

View File

@ -0,0 +1,37 @@
#!/bin/sh
# postrm script for setnet
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <postrm> `remove'
# * <postrm> `purge'
# * <old-postrm> `upgrade' <new-version>
# * <new-postrm> `failed-upgrade' <old-version>
# * <new-postrm> `abort-install'
# * <new-postrm> `abort-install' <old-version>
# * <new-postrm> `abort-upgrade' <old-version>
# * <disappearer's-postrm> `disappear' <overwriter>
# <overwriter-version>
# for details, see https://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
purge|remove|upgrade|failed-upgrade|abort-install|abort-upgrade|disappear)
;;
*)
echo "postrm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

View File

@ -0,0 +1,35 @@
#!/bin/sh
# preinst script for setnet
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <new-preinst> `install'
# * <new-preinst> `install' <old-version>
# * <new-preinst> `upgrade' <old-version>
# * <old-preinst> `abort-upgrade' <new-version>
# for details, see https://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
install|upgrade)
;;
abort-upgrade)
;;
*)
echo "preinst called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

View File

@ -0,0 +1,38 @@
#!/bin/sh
# prerm script for setnet
#
# see: dh_installdeb(1)
set -e
# summary of how this script can be called:
# * <prerm> `remove'
# * <old-prerm> `upgrade' <new-version>
# * <new-prerm> `failed-upgrade' <old-version>
# * <conflictor's-prerm> `remove' `in-favour' <package> <new-version>
# * <deconfigured's-prerm> `deconfigure' `in-favour'
# <package-being-installed> <version> `removing'
# <conflicting-package> <version>
# for details, see https://www.debian.org/doc/debian-policy/ or
# the debian-policy package
case "$1" in
remove|upgrade|deconfigure)
;;
failed-upgrade)
;;
*)
echo "prerm called with unknown argument \`$1'" >&2
exit 1
;;
esac
# dh_installdeb will replace this with shell code automatically
# generated by other debhelper scripts.
#DEBHELPER#
exit 0

View File

@ -0,0 +1,25 @@
#!/usr/bin/make -f
# See debhelper(7) (uncomment to enable)
# output every command that modifies files on the build system.
#export DH_VERBOSE = 1
# see FEATURE AREAS in dpkg-buildflags(1)
#export DEB_BUILD_MAINT_OPTIONS = hardening=+all
# see ENVIRONMENT in dpkg-buildflags(1)
# package maintainers to append CFLAGS
#export DEB_CFLAGS_MAINT_APPEND = -Wall -pedantic
# package maintainers to append LDFLAGS
#export DEB_LDFLAGS_MAINT_APPEND = -Wl,--as-needed
%:
dh $@
# dh_make generated override targets
# This is example for Cmake (See https://bugs.debian.org/641051 )
#override_dh_auto_configure:
# dh_auto_configure -- # -DCMAKE_LIBRARY_PATH=$(DEB_HOST_MULTIARCH)

View File

@ -0,0 +1,2 @@
README.Debian
README.source

View File

@ -0,0 +1,4 @@
#
# Regular cron jobs for the setnet package
#
0 4 * * * root [ -x /usr/bin/setnet_maintenance ] && /usr/bin/setnet_maintenance

View File

@ -0,0 +1,20 @@
dh_update_autotools_config
dh_auto_configure
dh_auto_build
dh_auto_test
dh_prep
dh_auto_install
dh_install
dh_installdocs
dh_installchangelogs
dh_installman
dh_perl
dh_link
dh_strip_nondeterminism
dh_compress
dh_fixperms
dh_installdeb
dh_gencontrol
dh_md5sums
dh_builddeb
dh_builddeb

View File

@ -0,0 +1,10 @@
# Defaults for setnet initscript
# sourced by /etc/init.d/setnet
# installed at /etc/default/setnet by the maintainer scripts
#
# This is a POSIX shell fragment
#
# Additional options that are passed to the Daemon.
DAEMON_OPTS=""

View File

@ -0,0 +1,20 @@
Document: setnet
Title: Debian setnet Manual
Author: <insert document author here>
Abstract: This manual describes what setnet is
and how it can be used to
manage online manuals on Debian systems.
Section: unknown
Format: debiandoc-sgml
Files: /usr/share/doc/setnet/setnet.sgml.gz
Format: postscript
Files: /usr/share/doc/setnet/setnet.ps.gz
Format: text
Files: /usr/share/doc/setnet/setnet.text.gz
Format: HTML
Index: /usr/share/doc/setnet/html/index.html
Files: /usr/share/doc/setnet/html/*.html

View File

@ -0,0 +1,2 @@
misc:Depends=
misc:Pre-Depends=

View File

@ -0,0 +1,2 @@
/etc/setnetrc
/etc/wpa_supplicant/wpa_setnet.conf

View File

@ -0,0 +1,14 @@
Package: setnet
Version: 0.2.1-1
Architecture: all
Maintainer: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
Installed-Size: 98
Depends: bash | busybox | dash | ksh | mksh | posh | yash, dhcp-client, dialog, iproute2, iw
Suggests: wpasupplicant, pastebinit, net-tools, iputils-ping, bind9-host, traceroute
Section: unknown
Priority: optional
Homepage: http://kalos.mine.nu/setnet
Description: simple shell/dialog tool to configure networks
setnet is a shell script with a dialog UI to configure ethernet
and wifi connections. It is meant to be POSIX-compliant, and has
been tested on bash, busybox, dash, ksh, mksh, posh, and yash.

View File

@ -0,0 +1,7 @@
980d58c2cd00e288713afd4a6531adb8 usr/sbin/setnet.sh
4172998fd574b48830832ab309394f0b usr/share/doc/setnet/ChangeLog
d690d59753d9fcd42667d50efb859a68 usr/share/doc/setnet/README.Debian
3cfe3b32a34f3283b5c35b4ca64d3a61 usr/share/doc/setnet/changelog.Debian.gz
99816219e17b3947549385cc94e2a822 usr/share/doc/setnet/changelog.gz
e5218c2f383b136780a03ba5e3f610b2 usr/share/doc/setnet/copyright
a70e42957c6759bdc0cf56a827a1e30a usr/share/man/man8/setnet.8.gz

View File

@ -0,0 +1,28 @@
##
##
## setnetrc -- configuration file for setnet
##
##
##
## WPA_FILE: The default configuration file for wpa_supplicant
##
WPA_FILE=/etc/wpa_supplicant/wpa_setnet.conf
##
## LOGFILE: Location of the logfile
##
LOGFILE=/var/log/setnet.log
##
## TRUNCATE_LOG: Truncate the log file at startup
##
TRUNCATE_LOG="yes"
##
## WIFI_DEVICES: List of Wi-Fi devices, to be used if automatic
## detection fails
##
##WIFI_DEVICES="wlan1 wlan3"

View File

@ -0,0 +1,4 @@
ctrl_interface=/var/run/wpa_supplicant
update_config=1
GROUP=wheel

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,11 @@
2017-01-07 KatolaZ <katolaz@freaknet.org>
* setnet.sh (configure_device): Improved wifi detection
* (netdiag_ping), (netdiag_traceroute),(netdiag_query):
changed dialog to programbox
* solved viasualitation bug in ip config
* added a manpage
* Added configuration variable "WIFI_DEVICES"
* The "Setup interface" menu has been reorganised
* added "Config IP Address" and "Manage Wifi Networking"

View File

@ -0,0 +1,132 @@
+--------------+
| setnet |
+--------------+
Copyleft (C) Vincenzo "KatolaZ" Nicosia <katolaz@freaknet.org>
2016, 2017
=== DESCRIPTION ===
setnet is a shell script with a dialog UI to configure ethernet and
wifi connections. It is meant to be POSIX-compliant, and has been
tested with bash, busybox, dash, ksh, mksh, posh, and yash. It is
still to be considered beta software, so you should use it AT YOUR OWN
RISK, but it is already fully functional.
=== LICENSE ===
setnet is Free Software, and can be used and distributed under the
terms of the GNU General Public License, either version 3 of the
licence or, at your option, any later version.
Please see the file LICENSE for more information
=== DEPENDENCIES ===
In order to run setset, you MUST satisfy this (relatively small) set
of dependencies:
- a posix-compliant shell (bash, busybox, dash, ksh, mksh, posh, and
yash have been tested)
- dialog (version 1.2 tested, but it should work with previous
versions as well)
- dhcp-client (for dhclient, tested with isc-dhcp-client)
- iproute2 (for ip)
- wireless-tools (for iwconfig, currently required for interface
identification)
Most of those tools might already be installed in your system anyway.
In particular, setnet uses:
- dialog: to provide a minimal Text-based User Interface,
- ip: to configure network interfaces and get information about them,
- dhclient: for DHCP-based IP configuration
- iwconfig: to check whether a network device is a wifi adapter
In order to use the full set of functionalities provided by setnet,
you MIGHT also need the following packages:
- wpa_supplicant (for wifi configuration)
- net-tools (for netstat, to gather information about network status)
- iputils-ping (for ping)
- bind9-nost (for host, used to check DNS configuration)
- traceroute (to trace the route between your host and any other host
in the Internet)
Again, most of them should be already installed in your system anyway.
=== USAGE ===
setnet is installed under /usr/sbin/setnet.sh. If invoked with "-h",
it provides a list of supported options:
$ ./setnet.sh -h
Usage: setnet.sh [OPTION]
Options:
-c cfg_file Load configuration from cfg_file.
-v Print version number and exit.
-h Show this help.
$
If the argument "-c" is specified, setnet will use the provided
configuration file. Otherwise, it will look for its configuration file
in one of the following locations:
- /etc/setnetrc
- ~/.setnetrc
in the given order. The following configuration variables should be
defined in setnetrc:
- WPA_FILE
This is the file configuration file used by wpa_supplicant.
- LOGNAME
This is the file used for logging.
- TRUNCATE_LOG
if equal to "yes", the log file will be truncated when setnet
starts
=== root vs. mortal users ===
Networking is an amdinistration task, and as such should be performed
by the host administrator, i.e., the user with UID 0 (normally called
"root"). However, in many modern GNU/Linux systems it is customary to
allow normal users to perform some administration tasks. There are at
least two concrete possibilities to allow a particular user (in the
following we call such user "fool") to configure network interfaces
using setnet.
-- 1) First approach: using sudo
If sudo is installed in your system, it is sufficient to add the
following line:
fool ALL=NOPASSWD: /usr/sbin/setnet.sh
to the file /etc/sudoers, and the user "fool" will be able to run
setnet.sh with effective UID 0 (i.e., as if it was root), by using the
command:
[fool@host]$ sudo /usr/sbin/setnet.sh
and thus will be able to perform all the needed admin tasks to
configure networking.
-- 2) Second approach: using sup
......TO BE DOCUMENTED......

View File

@ -0,0 +1,21 @@
Format: https://www.debian.org/doc/packaging-manuals/copyright-format/1.0/
Upstream-Name: setnet
Source: <http://kalos.mine.nu/setnet>
Files: debian/*
Copyright: 2016 Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
License: GPL-3+
This package is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 3 of the License, or
(at your option) any later version.
.
This package is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
.
You should have received a copy of the GNU General Public License
along with this program. If not, see <https://www.gnu.org/licenses/>
.

View File

@ -0,0 +1 @@
3.0 (quilt)

View File

@ -0,0 +1,39 @@
# Example watch control file for uscan
# Rename this file to "watch" and then you can run the "uscan" command
# to check for upstream updates and more.
# See uscan(1) for format
# Compulsory line, this is a version 4 file
version=4
# PGP signature mangle, so foo.tar.gz has foo.tar.gz.sig
#opts="pgpsigurlmangle=s%$%.sig%"
# HTTP site (basic)
#http://example.com/downloads.html \
# files/setnet-([\d\.]+)\.tar\.gz debian uupdate
# Uncommment to examine a FTP server
#ftp://ftp.example.com/pub/setnet-(.*)\.tar\.gz debian uupdate
# SourceForge hosted projects
# http://sf.net/setnet/ setnet-(.*)\.tar\.gz debian uupdate
# GitHub hosted projects
#opts="filenamemangle=s%(?:.*?)?v?(\d[\d.]*)\.tar\.gz%<project>-$1.tar.gz%" \
# https://github.com/<user>/setnet/tags \
# (?:.*?/)?v?(\d[\d.]*)\.tar\.gz debian uupdate
# PyPI
# https://pypi.python.org/packages/source/<initial>/setnet/ \
# setnet-(.+)\.tar\.gz debian uupdate
# Direct Git
# opts="mode=git" http://git.example.com/setnet.git \
# refs/tags/v([\d\.]+) debian uupdate
# Uncomment to find new files on GooglePages
# http://example.googlepages.com/foo.html setnet-(.*)\.tar\.gz

Binary file not shown.

File diff suppressed because it is too large Load Diff

View File

@ -0,0 +1,28 @@
##
##
## setnetrc -- configuration file for setnet
##
##
##
## WPA_FILE: The default configuration file for wpa_supplicant
##
WPA_FILE=/etc/wpa_supplicant/wpa_setnet.conf
##
## LOGFILE: Location of the logfile
##
LOGFILE=/var/log/setnet.log
##
## TRUNCATE_LOG: Truncate the log file at startup
##
TRUNCATE_LOG="yes"
##
## WIFI_DEVICES: List of Wi-Fi devices, to be used if automatic
## detection fails
##
##WIFI_DEVICES="wlan1 wlan3"

View File

@ -0,0 +1,4 @@
ctrl_interface=/var/run/wpa_supplicant
update_config=1
GROUP=wheel

Binary file not shown.

View File

@ -0,0 +1,31 @@
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 3.0 (quilt)
Source: setnet
Binary: setnet
Architecture: all
Version: 0.2.1-1
Maintainer: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
Homepage: http://kalos.mine.nu/setnet
Standards-Version: 3.9.8
Build-Depends: debhelper (>= 9)
Package-List:
setnet deb unknown optional arch=all
Checksums-Sha1:
c42046e917c513da3c6fb58443b87041cec8fdb5 13512 setnet_0.2.1.orig.tar.xz
a8a604ae41f5691e8f27079a4a228fc42e97a770 9744 setnet_0.2.1-1.debian.tar.xz
Checksums-Sha256:
ad3aec3ba1ac0bed6bad6643c98b6525b8e214e13059867263b2d44d827e6a7f 13512 setnet_0.2.1.orig.tar.xz
7314db77d9edf0c1cdb91c099a250406862908b5695c2e8bb5a7c3950c3d24a3 9744 setnet_0.2.1-1.debian.tar.xz
Files:
849e9456b1ae54102c9c93c287d6d883 13512 setnet_0.2.1.orig.tar.xz
871f301b52182e3f7607ea7ae2aff1c7 9744 setnet_0.2.1-1.debian.tar.xz
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
iEYEARECAAYFAlhxfy4ACgkQXyCzrgtfBi/n4ACfWWBF5Tv4W/oT/2Ui/H4RIb03
jboAnj6PzAbYCOK+oS8+0zzKKGIoqaC/
=9ABJ
-----END PGP SIGNATURE-----

Binary file not shown.

View File

@ -0,0 +1,42 @@
-----BEGIN PGP SIGNED MESSAGE-----
Hash: SHA1
Format: 1.8
Date: Sat, 07 Jan 2017 23:29:44 +0000
Source: setnet
Binary: setnet
Architecture: source all
Version: 0.2.1-1
Distribution: unstable
Urgency: medium
Maintainer: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
Changed-By: Vincenzo (KatolaZ) Nicosia <katolaz@freaknet.org>
Description:
setnet - simple shell/dialog tool to configure networks
Changes:
setnet (0.2.1-1) unstable; urgency=medium
.
* Version 0.2.1 -- See ChangeLog for details
Checksums-Sha1:
b12525f8d7e6b51ca59d6655ee9cd5ed5c3fa318 1043 setnet_0.2.1-1.dsc
c42046e917c513da3c6fb58443b87041cec8fdb5 13512 setnet_0.2.1.orig.tar.xz
a8a604ae41f5691e8f27079a4a228fc42e97a770 9744 setnet_0.2.1-1.debian.tar.xz
bf8645cb95e02bf64f0f3358936a410f903adcb7 17164 setnet_0.2.1-1_all.deb
Checksums-Sha256:
ae035925aeb117fc21391fa072a2a9ae3ad641708f55a226346655d86c57ee3a 1043 setnet_0.2.1-1.dsc
ad3aec3ba1ac0bed6bad6643c98b6525b8e214e13059867263b2d44d827e6a7f 13512 setnet_0.2.1.orig.tar.xz
7314db77d9edf0c1cdb91c099a250406862908b5695c2e8bb5a7c3950c3d24a3 9744 setnet_0.2.1-1.debian.tar.xz
86993feb74ffdc3513b8bbf57350350cf257b8712dd342cbc74bd6cd2aba25e1 17164 setnet_0.2.1-1_all.deb
Files:
f35dcc6fed24f56874010229819edf0b 1043 unknown optional setnet_0.2.1-1.dsc
849e9456b1ae54102c9c93c287d6d883 13512 unknown optional setnet_0.2.1.orig.tar.xz
871f301b52182e3f7607ea7ae2aff1c7 9744 unknown optional setnet_0.2.1-1.debian.tar.xz
1fa08b0edfbc742a23c14e5da2636591 17164 unknown optional setnet_0.2.1-1_all.deb
-----BEGIN PGP SIGNATURE-----
Version: GnuPG v2
iEYEARECAAYFAlhxfzEACgkQXyCzrgtfBi+BZgCeKrvmAAbbx4qO8G44/ox9hwOb
7moAn22VzMNMM5V8pHfTdr2cn84NB+fz
=wmeA
-----END PGP SIGNATURE-----

Binary file not shown.

View File

@ -5,18 +5,24 @@
##
##
## The default configuration file for wpa_supplicant
## WPA_FILE: The default configuration file for wpa_supplicant
##
WPA_FILE=/etc/wpa_supplicant/wpa_setnet.conf
##
## Logfile
## LOGFILE: Location of the logfile
##
LOGFILE=/var/log/setnet.log
##
## Truncate the log file at startup
## TRUNCATE_LOG: Truncate the log file at startup
##
TRUNCATE_LOG="yes"
##
## WIFI_DEVICES: List of Wi-Fi devices, to be used if automatic
## detection fails
##
##WIFI_DEVICES="wlan1 wlan4"