GNU.WIKI: The GNU/Linux Knowledge Base

  [HOME] [PHP Manual] [HowTo] [ABS] [MAN1] [MAN2] [MAN3] [MAN4] [MAN5] [MAN6] [MAN7] [MAN8] [MAN9]

  [0-9] [Aa] [Bb] [Cc] [Dd] [Ee] [Ff] [Gg] [Hh] [Ii] [Jj] [Kk] [Ll] [Mm] [Nn] [Oo] [Pp] [Qq] [Rr] [Ss] [Tt] [Uu] [Vv] [Ww] [Xx] [Yy] [Zz]


       lcdexec - LCDproc client to execute commands from the LCDd menu


       lcdexec [-hf] [-c config] [-a addr] [-p port] [-r level] [-s bool]


       lcdexec connects to LCDd (the LCDproc server) and adds a submenu to the
       LCDd main menu that allows the user to select commands to be  executed.
       You can access the menu by pressing the menu key configured for LCDd.


       lcdexec  understands the following command line options., that override
       the corresponding options given in the configuration file:

       -c filename
               Set the name of the config file to read,  /etc/lcdexec.conf  by

       -a address
               Set the address of the host which LCDd is running on, localhost
               by default

       -p port Set the port which LCDd is accepting connections on,  13666  by

       -f      Run in foreground.

       -r level
               Set   the  reporting  level  to  level,  which  is  an  integer
               representing the reporting levels from 0 (critical errors only)
               to 5 (debug messages).  Default is 2 (errors and warnings only)

       -s bool Report to syslog (1) or to stdout (0, default)


       In addition to the command line options listed above lcdexec also takes
       options from a configuration file.

       This file is expected to have a "INI-file" like  format  with  sections
       introduced  by  section  headers  in  square brackets and options lines
       consisting of key=value pairs.

       Section and option names may contain only characters from the range [a-
       zA-Z0-9_],  while  value  strings  may contain any printable character.
       Value strings with characters outside the range  [a-zA-Z0-9_]  must  be
       quoted with double quotes.  To get a double quote or backslashes in the
       string, they must be escaped by preceding it by a backslash.

       The lcdexec configuration file needs at least two sections:

               for the general options

               for the top level of the menu hierarchy to be displayed.

       The [lcdexec] section supports the following options:

               The host name or IP address of the LCDd server to  connect  to.
               If not given, server defaults to localhost.

               Port  of  the server to connect to.  The default value for port
               is 13666, the LCDproc port.

               Set  the  reporting  level  to  level,  which  is  an   integer
               representing the reporting levels from 0 (critical errors only)
               to 5 (debug messages).  Default is 2 (errors and warnings only)

               Tell whether to report to syslog (TRUE) or to stderr (FALSE).

               Tell whether to run  in  foreground  (TRUE)  or  in  background
               (FALSE).  If not given, the default is FALSE for daemon mode.

               Set  the  display  name  for  the  main  menu.  If not given it
               defaults to lcdexec HOST, where HOST is  the  hostname  of  the
               system lcdexec is running on.

               Set  the  shell  to use when executing programs.  If not given,
               lcdexec tries to read the environment variable SHELL.  If  that
               fails,  it  defaults  to  /bin/sh.   Please note that the shell
               given here must  understand  the  option  -c  followed  by  the
               command line to execute.

       The  [MainMenu]  section  and the sections it refers to define the menu
       hierarchy to be displayed.  Each menu and each menu entry in  the  menu
       hierarchy  is defined as its own section.  Whether a given section is a
       sub-menu or a command entry is defined by the option keys occurring  in
       the section.

       Menu / menu entry sections may contain the following options:

               Defines  a  menu  entry entry which is further specified in the
               section [entry].

               Sections containing one or more Entry= options are menus.

               Defines the system command command to  be  executed  when  this
               entry gets selected.

               Sections containing an Exec= option are command entries.

               The name of the menu entry to be displayed on the LCD.  If this
               option is not given,  the  the  section  header  name  is  used
               (without the square brackets).

               In  command  entries,  this  option tells whether to inform the
               user of the completion of commands using an alert screen on the
               display.  If not given, it defaults to no.




       In the configfile:

       ## general options for lcdexec ##
       # address of the LCDd server to connect to

       # Port of the server to connect to

       # set reporting level

       # report to to syslog ?

       # run in foreground [default: false; legal: true, false]

       # display name for the main menu [default: lcdexec HOST]

       # main menu definition
       # the Entry=... lines (one for each menu entry) tell it is a menu definition

       # definition of a command
       # name to display in the menu instead of the section name
       DisplayName="Eject CD-ROM"
       # the Exec=... line tells that it is a command
       Exec="umount /cdrom; cdeject"

       # definition of a menu
       DisplayName="Shutdown menu"
       # a menu contains an Entry=... line for each menu entry

       DisplayName="Shutdown in 5 minutes"
       Exec="shutdown -h +5"

       DisplayName="Reboot in 5 minutes"
       Exec="shutdown -r +5"

       DisplayName="Cancel shutdown/reboot"
       Exec="shutdown -c"

       DisplayName="Shutdown now"
       Exec="shutdown -h now"

       DisplayName="Reboot now"
       Exec="shutdown -r now"

       Start lcdexec with: lcdexec -c /usr/local/etc/lcdexec.conf

       This  will  allow  you  to  eject  the CD-ROM by opening the LCDd menu,
       selecting "lcdexec" and selecting "Eject CD-ROM".   Further  it  allows
       you  to  do various shutdowns, among others the "Shutdown in 5 minutes"
       by opening the LCDd  menu,  selecting  "lcdexec",  selecting  "Shutdown
       menu" and selecting "Shutdown in 5 minutes".




       lcdexec  is  written by Joris Robijn and Peter Marschall. It is part of
       the LCDproc suite.

       The newest version of LCDproc should be available from here:



       LCDproc is released as "WorksForMe-Ware".  In other words, it is  free,
       kinda  neat,  and  we  don't  guarantee  that  it  will  do anything in
       particular on any machine except the ones it was developed on.

       It is technically released under the GNU GPL license (you  should  have
       received   the   file,   "COPYING",   with   LCDproc)  (also,  look  on for more information), so you  can  distribute  and
       use  it  for free -- but you must make the source code freely available
       to anyone who wants it.

       For any sort of real legal information, read the GNU GPL  (GNU  General
       Public License).  It's worth reading.

  All copyrights belong to their respective owners. Other content (c) 2014-2018, GNU.WIKI. Please report site errors to
Page load time: 0.181 seconds. Last modified: November 04 2018 12:49:43.