/*
* GProFTPD - A GTK+ frontend for the ProFTPD standalone server.
* Copyright (C) 2001 - 2006 Magnus Loef (Magnus-swe) <magnus-swe@telia.com>
*
* This program 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 2 of the License, or
* (at your option) any later version.
*
* This program 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, write to the Free Software
* Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307, USA.
*
*/
#include <gtk/gtk.h>
#include "../config.h"
#include "support.h"
#include "gettext.h"
#include "widgets.h"
void show_help()
{
gchar *help_text;
GtkWidget *help_window, *vbox15, *scrolledwindow16;
GtkWidget *help_textview, *close_help_button;
GtkWidget *alignment19, *hbox52, *image19, *label109;
help_window = gtk_window_new (GTK_WINDOW_TOPLEVEL);
gtk_widget_set_name (help_window, "help_window");
gtk_widget_set_size_request (help_window, 650, 350);
gtk_window_set_title (GTK_WINDOW (help_window), _("GProftpd help"));
gtk_window_set_position (GTK_WINDOW (help_window), GTK_WIN_POS_CENTER);
vbox15 = gtk_vbox_new (FALSE, 0);
gtk_widget_set_name (vbox15, "vbox15");
gtk_widget_show (vbox15);
gtk_container_add (GTK_CONTAINER (help_window), vbox15);
scrolledwindow16 = gtk_scrolled_window_new (NULL, NULL);
gtk_widget_set_name (scrolledwindow16, "scrolledwindow16");
gtk_widget_show (scrolledwindow16);
gtk_box_pack_start (GTK_BOX (vbox15), scrolledwindow16, TRUE, TRUE, 0);
gtk_scrolled_window_set_policy (GTK_SCROLLED_WINDOW (scrolledwindow16), GTK_POLICY_AUTOMATIC, GTK_POLICY_ALWAYS);
help_textview = gtk_text_view_new ();
gtk_widget_set_name (help_textview, "help_textview");
gtk_widget_show (help_textview);
gtk_container_add (GTK_CONTAINER (scrolledwindow16), help_textview);
gtk_text_view_set_editable (GTK_TEXT_VIEW (help_textview), FALSE);
gtk_text_view_set_cursor_visible (GTK_TEXT_VIEW (help_textview), FALSE);
gtk_text_view_set_left_margin (GTK_TEXT_VIEW (help_textview), 30);
gtk_text_view_set_right_margin (GTK_TEXT_VIEW (help_textview), 10);
help_text = g_strconcat(
_("\n\nAdding users:\n\n"),
_("When adding a user you can randomize its username and password or use your own.\n"),
_("You can also select its login shell, group, comment and toplevel ftp home directory.\n"),
_("Press add when you are satisfied with the users settings.\n"),
_("When the user has been added you can add and set permissions on its directories.\n\n"),
_("Any other directories added must be located below the ftp home directory for this user.\n\n"),
_("If you need to add more users with similar settings you can simply change a current users\n"),
_("username, password and directory and then press the add button.\n\n"),
_("\nTypical setups:\n\n"),
_("Users needs upload access to a http servers directory:\n\n"),
_("Set the users home directory to the webserver's root directory IE:\n"),
_("/var/www/html or /var/www/html/UserName for a private homepage.\n"),
_("Press add when you are satisfied with the users settings.\n"),
_("Add the required upload permissions for this users directory and press apply.\n\n"),
_("\nAdding anonymous access to a directory:\n\n"),
_("Type anonymous in the username field.\n"),
_("Press the password randomize button or type a password longer then 5 chars.\n"),
_("Type anonymous as group and comment.\n"),
_("Select /dev/null shell.\n"),
_("Set require password to off.\n"),
_("Type this users home directory IE: /var/ftp/anonymous.\n"),
_("Press add to add this anonymous user.\n"),
_("You can now login as anonymous with no password.\n\n"),
_("If the selected shell is false or null the user can only login to this ftpserver otherwise\n"),
_("that user gets a private home directory as well as its ftp directory and can login via ssh\n"),
_("etc if that server allows the user to do so.\n\n"),
_("You can easily add more servers to run on different interfaces and ports.\n"),
_("The same users can have different directories and settings in different servers.\n"),
_("When a user connects to one address and port it gets access according to that servers\n"),
_("configuration for that user.\n"),
_("If you want to turn a server off without deleting it you can set its port value to 0\n\n"),
_("If this Proftpd server is behind a NAT gateway you should specify the gateways\n"),
_("external DNS name or IP-address as \"Configure NAT routing\" and then turn it on.\n\n"),
_("If you want to add directories thats not under the users root directory you can do this:\n\n"),
_("Linux (as of kernel 2.4.0):\n"),
_("mount --bind /some/directory/to/share /var/ftp/make_this_directory_first\n\n"),
_("Alternatively:\nmount -o bind /var/data /var/ftp/bob/data\n\n"),
_("*BSD (as of 4.4BSD):\nmount_null /var/data /var/ftp/bob/data\n\n"),
_("Solaris:\nmount -F lofs /var/data /var/ftp/bob/data\n\n"),
_("Statistics:\n\n"),
_("Pressing the generate welcome statistics button in the file tab will create\n"),
_("welcome messages for all users in this FTP server\n"),
_("Pressing generate HTML statistics in the file tab creates top 10\n"),
_("upload and download statistics as a webpage IE: /var/www/html/ftp.htm\n\n"),
_("With crond and gprostats you can do this to have it automatically update the statistics:\n"),
_("gprostats -html /path/to/output.html\ngprostats -w welcome.msg\n"),
_("or both at the same time: gprostats -html /path/to/output.html -w welcome.msg\n"),
_("Use -c /path/to/proftpd.conf -x /path/to/xferlog if you need to.\n\n"),
_("If you have made customized welcome messages and dont want them overwritten by gprostats\n"),
_("you can configure this by doubleclicking a user and unchecking update statistics.\n"),
_("then pressing the apply button, this will also exclude the user from the html output.\n\n"),
_("If you copy or move a file directly to the ftpservers directory you may need to\n"),
_("chmod it with 644 and chmod directories to 755 so that the directory and file can be accessed.\n\n"),
_("This is one way of chmodding all files recursively in the directory /var/ftp:\n"),
_("find /var/ftp -type f -exec chmod 644 -v {} \\;\n\n"),
_("Upload directories should have a chmod of 777 and this can be used for /var/ftp/upload\n"),
_("find /var/ftp/upload -type d -exec chmod 777 -v {} \\;\n\n\n"),
_("For more detailed information about the server and its configuration directives visit:\n"),
_("http://www.proftpd.org\n"), NULL);
gtk_text_buffer_set_text (gtk_text_view_get_buffer (GTK_TEXT_VIEW (help_textview)), help_text, -1);
if( help_text!=NULL )
g_free(help_text);
close_help_button = gtk_button_new ();
gtk_widget_set_name (close_help_button, "close_help_button");
gtk_widget_show (close_help_button);
gtk_box_pack_start (GTK_BOX (vbox15), close_help_button, FALSE, FALSE, 0);
alignment19 = gtk_alignment_new (0.5, 0.5, 0, 0);
gtk_widget_set_name (alignment19, "alignment19");
gtk_widget_show (alignment19);
gtk_container_add (GTK_CONTAINER (close_help_button), alignment19);
hbox52 = gtk_hbox_new (FALSE, 2);
gtk_widget_set_name (hbox52, "hbox52");
gtk_widget_show (hbox52);
gtk_container_add (GTK_CONTAINER (alignment19), hbox52);
image19 = gtk_image_new_from_stock ("gtk-close", GTK_ICON_SIZE_BUTTON);
gtk_widget_set_name (image19, "image19");
gtk_widget_show (image19);
gtk_box_pack_start (GTK_BOX (hbox52), image19, FALSE, FALSE, 0);
label109 = gtk_label_new_with_mnemonic (_("Close"));
gtk_widget_set_name (label109, "label109");
gtk_widget_show (label109);
gtk_box_pack_start (GTK_BOX (hbox52), label109, FALSE, FALSE, 0);
gtk_label_set_justify (GTK_LABEL (label109), GTK_JUSTIFY_LEFT);
g_signal_connect_swapped(close_help_button, "clicked",
G_CALLBACK (gtk_widget_destroy),
GTK_OBJECT (help_window));
gtk_widget_show_all(help_window);
}
syntax highlighted by Code2HTML, v. 0.9.1