.\" $NetBSD: sushi.8,v 1.3 2001/01/08 21:19:31 garbled Exp $ .\" Copyright (c) 2001 The NetBSD Foundation, Inc. .\" All rights reserved. .\" .\" This code is derived from software contributed to The NetBSD Foundation .\" by Tim Rightnour .\" .\" Redistribution and use in source and binary forms, with or without .\" modification, are permitted provided that the following conditions .\" are met: .\" 1. Redistributions of source code must retain the above copyright .\" notice, this list of conditions and the following disclaimer. .\" 2. Redistributions in binary form must reproduce the above copyright .\" notice, this list of conditions and the following disclaimer in the .\" documentation and/or other materials provided with the distribution. .\" 3. All advertising materials mentioning features or use of this software .\" must display the following acknowledgement: .\" This product includes software developed by the NetBSD .\" Foundation, Inc. and its contributors. .\" 4. Neither the name of The NetBSD Foundation nor the names of its .\" contributors may be used to endorse or promote products derived .\" from this software without specific prior written permission. .\" .\" THIS SOFTWARE IS PROVIDED BY THE NETBSD FOUNDATION, INC. AND CONTRIBUTORS .\" ``AS IS'' AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED .\" TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR .\" PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE FOUNDATION OR CONTRIBUTORS .\" BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR .\" CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF .\" SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS .\" INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN .\" CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) .\" ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE .\" POSSIBILITY OF SUCH DAMAGE. .\" .Dd January 8, 2001 .Dt SUSHI 8 .Os .Sh NAME .Nm sushi .Nd a menu based system administration tool .Sh SYNOPSIS .Nm .Op Ar quickname .Sh DESCRIPTION The .Nm tool gives the user a menu of various system administration tasks that may be performed on the system. It is designed to be simple enough for a novice to use, and quick enough to help seasoned users perform more complex tasks with ease. .Pp It is also designed to be easily extended and customizable by the user or administrator. The menus themselves consist of a number of flat ascii files which are parsed by the .Nm engine when run. Commands are actually scripts written by the administrator, and executed from the menu heirarchy. It is possible to have multiple heirarchies, and even ones private to a particular user on the machine. These hierarchies are all merged for the user at run-time into a single menu system. .Pp The following option is available: .Bl -tag -width "quickname" .It Ar quickname This option allows the user to jump directly to a known submenu or function within .Nm . It can be used to avoid the need to navigate deeply nested menus, when the end destination is known. .El .Sh ENVIRONMENT The following environment variables are utilized by .Nm : .Bl -tag -width "PKG_PATH" .It Ev LANG Determines the user's current language setting. .It Ev PKG_PATH This is the default URL for binary packages used when fetching lists of packages available to download. It is also used when actually downloading those packages. It defaults to: ftp://ftp.netbsd.org/pub/NetBSD/packages .El .Pp There may be other environment variables utilized by various scripts in the .Nm menu hierarchy. This manual page cannot account for those environment variables, however they should be detailed in the help files for each menu. .Sh FILES .Bl -tag -width "sushi" .It Pa /etc/sushi.conf This file is used by sushi to override the default locations searched for menu hierarchies. It consists of directory names, one per line, that will be searched, in order, for menu hierarchies. It is not an error to have a non-existant directory listed in this file, as they will simply be skipped over. The default list of directories searched is printed below, in order: .It Pa /usr/share/sushi .It Pa /usr/pkg/share/sushi .It Pa /usr/X11R6/share/sushi .It Pa /etc/sushi .It Pa $HOME/sushi The $HOME/sushi path, is allways searched, and does not need to appear in the .Pa /etc/sushi.conf file. The .Pa /etc/sushi.conf file will not be parsed for environment variables such as $HOME, so it would likely be an error to include it there. .El .Sh EXAMPLES .Pp Most of the actual usage of .Nm is documented in the internal help files, such as commands, and keystrokes that are used to navigate the menus. There is also full documentation in the help pages on writing your own menus. In order to access help, you may hit the F1 key at any time, and if help is available for the current menu, it will be displayed. It is advised that the user read the help file from the main menu, as it contains most of the navigation, and basic concepts of the .Nm engine. .Sh SEE ALSO .Xr rc.conf 5 , .Xr intro 8 . .Sh BUGS At the time of this writing, there are a number of display glitches which are currently being worked on. In addition there are some failure modes that .Nm does not handle well, such as not recieving output from an escript field. .Pp At the time of this writing, the F6 option, to display the current command before running it, does not work. .Sh AUTHORS .Nm was written by Tim Rightnour .Ad garbled@netbsd.org and Dante Profeta .Ad dante@netbsd.org . .Sh HISTORY .Nm first appeared in .Nx 1.6 .