diff options
Diffstat (limited to 'debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet')
5 files changed, 194 insertions, 0 deletions
diff --git a/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/ChangeLog b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/ChangeLog new file mode 100644 index 0000000..18e95e6 --- /dev/null +++ b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/ChangeLog @@ -0,0 +1,41 @@ +2017-03-08 KatolaZ <katolaz@freaknet.org> + + * setnet.sh (wifi_restart_wpa): Corrected a bug in the restart of + wpa_supplicant. + +2017-03-07 KatolaZ <katolaz@freaknet.org> + + * setnet.sh (check_deps): Corrected a small bug in the parsing of options + +2017-01-29 KatolaZ <katolaz@freaknet.org> + + * setnet.sh: + * removed "Load file" and "New File" in WiFi configuration + +2017-01-23 KatolaZ <katolaz@freaknet.org> + + * setnet.sh: + * fixed a few minors bugs + +2017-01-20 KatolaZ <katolaz@freaknet.org> + + * setnet.sh (0.3): + * implemented check of running shell + * implemented workaround for zsh -- now fully supported + * added chk_out and chk_exit + * all direct commands (e.g., ip, wpa_cli) are now checked + * added support for EAP/PEAP + * added support for EAP/TLS + + +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" + diff --git a/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/README.Debian b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/README.Debian new file mode 100644 index 0000000..0cad044 --- /dev/null +++ b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/README.Debian @@ -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...... + + diff --git a/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.Debian.gz b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.Debian.gz Binary files differnew file mode 100644 index 0000000..86d5e1d --- /dev/null +++ b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.Debian.gz diff --git a/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.gz b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.gz Binary files differnew file mode 100644 index 0000000..2725afb --- /dev/null +++ b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/changelog.gz diff --git a/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/copyright b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/copyright new file mode 100644 index 0000000..f425891 --- /dev/null +++ b/debian_package/setnet-0.3.2/debian/setnet/usr/share/doc/setnet/copyright @@ -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/> + . + |