DIALOG() User commands DIALOG() (NAME) dialog - (SYNOPSIS) dialog --clear dialog --create-rc file dialog --print-maxsize dialog common-options box-options (DESCRIPTION) Dialog . ( dialog ): buildlist calendar checklist dselect editbox form fselect gauge infobox inputbox inputmenu menu mixedform mixedgauge msgbox () passwordbox passwordform pause prgbox programbox progressbox radiolist rangebox tailbox tailboxbg textbox timebox treeview yesno (/). : o "--and-widget" dialog ESC o . ( Cancel No) Dialog ( ). checklist dialog . : "--output-fd" "--stderr" "--stdout". Cancel ( ESC) dialog . (OPTIONS) "--" ( ). "--" . getopt(1) . dialog --title -- --Not an option dialog --title This -- --title is not an option Dialog . ( ) . ( ) "no" "--" . --no-shadow --shadow . "--args" dialog . "--" "--file" . "--file" dialog . dialog --file parameterfile ( ). "--file" . . parameterfile "&" dialog . height width (prompt) : o dialog . o dialog prompt . o dialog . (Common Options) . --ascii-lines "+" "-" . "--no-lines" . --aspect ratio ( ) . / . 9 9 1 . --backtitle backtitle backtitle . --begin y x . --cancel-label string "Cancel" . --clear screen_color . "--and-widget" . "--keep-window" . : 1 2 3: dialog \ --begin 2 2 --yesno "" 0 0 \ --and-widget --begin 4 4 --yesno "" 0 0 \ --and-widget --begin 6 6 --yesno "" 0 0 : dialog \ --clear --begin 2 2 --yesno "" 0 0 \ --and-widget --clear --begin 4 4 --yesno "" 0 0 \ --and-widget --begin 6 6 --yesno "" 0 0 3 2 1: dialog \ --keep-window --begin 2 2 --yesno "" 0 0 \ --and-widget --keep-window --begin 4 4 --yesno "" 0 0 \ --and-widget --begin 6 6 --yesno "" 0 0 3 1: dialog \ --keep-window --begin 2 2 --yesno "" 0 0 \ --and-widget --clear --begin 4 4 --yesno "" 0 0 \ --and-widget --begin 6 6 --yesno "" 0 0 clear(1) . dialog --erase-on-exit . --color-mode code --colors programbox tailbox textbox . "2" . --colors "\Z" dialog : o 0 7 ANSI curses : (magenta) (cyan) . o (Bold) 'b' 'B' . o (Reverse) 'r' 'R' . o (Underline) 'u' 'U' . o "\Zb\Z1" ( ) . o "\Zn" . --column-separator string dialog / . --cr-wrap . dialog . Dialog . cr-wrap . cr-wrap : o "\n" --no-nl-expand o --trim . (Whitespace Options) . --create-rc file dialog file . --cursor-off-label . . --date-format format strftime --calendar . ( ) . --defaultno yes/no No . "OK" "Cancel" Cancel . "--no-cancel" "--visit-items" "Yes" ( "OK" ). --default-button string ( ) . Enter . : ok yes cancel no help extra. . "--no-ok" "--no-cancel" . . --default-item string . . --erase-on-exit dialog . --exit-label string "EXIT" . --extra-button "OK" "Cancel" . yesno "Yes" "No" . --extra-label string "Extra" . : inputmenu "Rename" . --help . . --help-button "OK" "Cancel" ( checklist radiolist menu treeview) . yesno "Yes" "No" . Help . Dialog "HELP" : o "--item-help" . o ( ) . --help-tags / DIALOG_ITEM_HELP . "OK" "Cancel" . . --help-label string "Help" . --help-status "HELP" . . --help-tags --help-button . . --hfile filename textbox F1 . --hline string . . 9 . . --ignore dialog . "--icon" . --input-fd fd . dialog gauge ( ). dialog . ( ) . --insecure . --iso-week "--calendar" ISO-8601 . --item-help . --keep-tite ncurses dialog xterm . dialog . dialog . --keep-window dialog tailboxbg "--and-widget" . . dialog "--keep-window" tailboxbg . . "--clear" . --last-key . curses . . --max-input size . 2048 . --no-cancel "Cancel" inputbox . ESC . --no-collapse dialog . . dialog "--cr-wrap" "--trim" . no-collapse : o "\n" --no-nl-expand o --trim . (Whitespace Options) . --no-hot-list dialog . . . ("OK" "Cancel" ) . --no-items (checklist inputmenu radiolist menu) ( "tag" "item" "description"). dialog "item" . . --no-tags . . --no-kill dialog tailboxbg dialog . SIGHUP . --no-label string "No" . --no-lines . "--ascii-lines" . --no-mouse . --no-nl-expand "\n" / . no-nl-expand "\n" . (Whitespace Options) . --no-ok "OK" . "Enter" : o --no-ok "Enter" "OK" . LEAVE . --no-ok Tab . "Enter" . o --no-ok LEAVE . ^D (EOF) . --no-shadow . --no-tags (checklist inputmenu radiolist menu) ( "tag" "description"). . --no-tags ( Xdialog) . --no-items . Xdialog buildlist treeview dialog . dialog . --no-tags dialog . . --ok-label string "OK" . --output-fd fd . dialog . --separator string --output-separator string dialog ( --separate-output) . editbox . --print-maxsize ( ) dialog . . --print-size dialog . --print-text-only string [ height [ width ] ] dialog . height width dialog . --print-text-size string [ height [ width ] ] dialog : height width height width dialog . --print-version dialog dialog . . dialog . --quoted dialog . ( ). --reorder buildlist () () . dialog . --scrollbar . . --separate-output (buildlist checklist treeview) . . --separate-widget string dialog . . . --single-quoted ( ) . dialog . dialog . . --size-err . ( ). --sleep secs . --stderr . curses . --stdout . Xdialog curses . dialog . . --tab-correct ( textbox ). curses . --no-collapse . --tab-len n "--tab-correct" . 8 . textbox . --time-format format strftime --timebox . . --timeout secs . . ESC . . DIALOG_TIMEOUT dialog . "--pause" . "--tailboxbg" . --title title title . --trace filename . dialog . gauge . control/T . dialog . --trace dialog ( ) . --week-start day "--calendar" . day : o (0 6 POSIX) o "locale" ( glibc locale first_weekday). o calendar "Mo" . --trim . trim : o "\n" o --no-nl-expand . (Whitespace Options) . "--cr-wrap" "--no-collapse" . --version dialog . "--print-version" . --visit-items Tab menubox inputmenu . . . ( ) . Tab . --yes-label string "Yes" . (Box Options) : text . height . width . . --buildlist text height width list-height [ tag item status ] ... buildlist . . . . "OK" . . / status . menu --visit-items . o --visit-items Tab (OK/Cancel) . o --visit-items Tab (Left/Right/OK/Cancel) . --visit-items "^" ( ) "$" ( ) . tag dialog . "--separate-output" . . "--single-quoted" . --calendar text height width day month year calendar . day month year . ( ) . vi h j k l . Tab Backtab . . // . --date-format . --checklist text height width list-height [ tag item status ] ... checklist menu . status on . . / status . tag dialog . "--separate-output" . . "--single-quoted" . --dselect filepath height width . filepath . Tab . / . . . "OK" . dialog . --editbox filepath height width edit-box . backspace delete . pageup/pagedown . --inputbox Tab "OK" "Cancel" . "Enter" . dialog . --form text height width formheight [ label y x item y x flen ilen ] ... form . flen ilen . . o flen . o flen flen . o ilen flen . / ( control/N control/P) . Tab . dialog . (flen ) . --fselect filepath height width fselect ( ) ( ) . filepath . Tab . / . . . dialog ( ). "OK" . dialog . --gauge text height width [percent] gauge . . . . "XXX" "XXX" . (EOF) gauge . percent . . dialog . OK . --infobox text height width info message . dialog . dialog . . dialog . OK . --inputbox text height width [init] input . init . backspace delete . . dialog . --inputmenu text height width menu-height [ tag item ] ... inputmenu menu . : 1. . 2. ( Rename) . 3. Rename . dialog dialog : RENAMED --menu text height width menu-height [ tag item ] ... menu . . tag item . tag . item . tag 1 9 . menu-height . tag dialog . "--help-button" . --mixedform text height width formheight [ label y x item y x flen ilen itype ] ... mixedform --form. . : 1 . 2 . --mixedgauge text height width percent [ tag1 item1 ] ... mixedgauge . . tag item . dialog(3) . text . percent . --gauge . dialog . OK . --msgbox text height width message yes/no . message yes/no message OK . . ENTER dialog . dialog curses . . dialog . "OK" ESC . --pause text height width seconds pause . . OK ( OK) CANCEL Esc . --passwordbox text height width [init] password inputbox . . "init" . . "init" . "--insecure" . dialog . --passwordform text height width formheight [ label y x item y x flen ilen ] ... --form password inputbox. --prgbox text command height width --prgbox command height width prgbox programbox . prgbox . ENTER dialog . . . --programbox text height width --programbox height width programbox progressbox . program progress program OK ( ). . ENTER dialog . . . --progressbox text height width --progressbox height width progressbox tailbox : ) ) ( "OK" ). . . --radiolist text height width list-height [ tag item status ] ... radiolist menu . status on . dialog . --rangebox text height width min-value max-value default-value . ( gauge) . Tab . : / +/- / 0 9 : home/end pageup/pagedown --tailbox file height width "tail -f". vi 'h' 'l' / . '0' . dialog . "OK" ESC . --tailboxbg file height width "tail -f &". vi 'h' 'l' / . '0' . (--and-widget) Dialog . ( "OK") dialog tailboxbg . Tab ENTER . tailboxbg dialog "--no-kill" . dialog . "EXIT" ESC . : dialog . . . --textbox file height width text . . page-up page-down HOME/END . LEFT/RIGHT . vi h j k l B N page-up page-down . 'k' 'j' vi / . 'h' 'l' vi / . '0' / . vi . dialog . "EXIT" ESC . --timebox text height [width hour minute second] . . . Tab Backtab . :: . --time-format . --treeview text height width list-height [ tag item status depth ] ... . ("on" "off") . ( radiolist). . dialog . --yesno text height width yes/no height width . text . . text "\n" `\n' . . Yes No TAB . dialog . "Yes" "No" ( ) ESC . "Yes" "No" "OK" "Cancel" . (Obsolete Options) --beep cdialog tailboxbg . --beep-after . (Whitespace Options) ( ) dialog : --cr-wrap --no-collapse --no-nl-expand --trim : o Dialog "\n" ( --no-nl-expand ) --no-collapse --trim . o "\n" --no-nl-expand dialog --trim . --trim dialog --no-collapse . ( -cr-wrap ) . o "\n" --trim dialog --no-collapse . dialog --cr-wrap . . "\n" --no-nl-expand . cr- no- no- trim wrap collapse nl-expand -------------------------------------------------------------------- no no no no . . "\n" . no no no yes . . "\n" . no no yes no . . . "\n". no no yes yes . . . "\n". no yes no no . "\n" . no yes no yes . "\n" . no yes yes no . . "\n". no yes yes yes . . "\n". yes no no no . . "\n" . yes no no yes . . "\n" . yes no yes no . . . "\n". yes no yes yes . . . "\n". yes yes no no . "\n" . yes yes no yes . "\n" . yes yes yes no . . "\n". yes yes yes yes . . "\n". (RUN-TIME CONFIGURATION) 1. : dialog --create-rc file 2. dialog : ) DIALOGRC . ) () $HOME/.dialogrc . ) () GLOBALRC /etc/dialogrc . ) () . 3. dialog . (KEY BINDINGS) dialog . bindkey Dialog . bindkey widget curses_key dialog_key widget "*" ( ) textbox . "*" . . curses_key : o curses.h "HELP" "KEY_HELP". o Dialog ANSI "^A" "^?" C1 "~A" "~?" . o dialog C . "\033" ( escape ) : --------------------------------------------------------------- \b backspace \f form feed \n new line (line feed) \r carriage return \s space \t tab \^ "^" (caret) \? "?" (question mark) \\ "\" (backslash) --------------------------------------------------------------- Dialog DLG_KEYS_ENUM dlg_keys.h "HELP" "DLGK_HELP". (Widget Names) ( formbox) . . ------------------------------------------------------------------------------ calendar calendar checklist checklist editbox editbox editbox2 form formbox formfield fselect fselect fselect2 inputbox inputbox inputbox2 menu menubox menu msgbox msgbox pause pause progressbox progressbox radiolist radiolist tailbox tailbox textbox textbox searchbox timebox timebox yesno yesno ------------------------------------------------------------------------------ . : -------------------------------------------- dselect fselect infobox msgbox inputmenu menu mixedform form passwordbox inputbox passwordform form prgbox progressbox programbox progressbox tailboxbg tailbox -------------------------------------------- (Built-in Bindings) dialog . --trace dialog . : ------------------------------------------------------------------------------------------------------------------------------------------------ Control-I Tab --tailboxbg. Control-L . Control-T --trace. Control-V . DLGK_FIELD_NEXT Tab Control-I. DLGK_FIELD_PREV Tab back-tab. DLGK_HELPFILE --hfile. KEY_BTAB Tab --tailboxbg. ------------------------------------------------------------------------------------------------------------------------------------------------ (Example) dialog . Tab ( Backtab) ( ) . Tab tailboxbg. . form dlgk_keys.h "form" (///) . : bindkey formfield TAB form_NEXT bindkey formbox TAB form_NEXT bindkey formfield BTAB form_prev bindkey formbox BTAB form_prev calendar . (EXIT STATUS) . : 0 YES OK (DIALOG_OK). 1 No Cancel (DIALOG_CANCEL). 2 Help (DIALOG_HELP) DIALOG_ITEM_HELP . 3 Extra (DIALOG_EXTRA). 4 Help --item-help DIALOG_ITEM_HELP 4 . 2004 . Dialog DIALOG_ITEM_HELP (4) DIALOG_HELP (2) . 5 DIALOG_TIMEOUT 5 . -1 dialog (DIALOG_ERROR) dialog ESC (DIALOG_ESC) . (ENVIRONMENT) DIALOGOPTS . . dialog . "--file" . "--file" ( ). DIALOGRC . DIALOG_CANCEL DIALOG_ERROR DIALOG_ESC DIALOG_EXTRA DIALOG_HELP DIALOG_ITEM_HELP DIALOG_TIMEOUT DIALOG_OK : o (1) o (-1) o ESC (255) o Extra (3) o Help (2) o Help --item-help (2) o (5) o OK (0). -1 255 . DIALOG_TTY "1" dialog "--stdout" . (FILES) $HOME/.dialogrc (PORTABILITY) Dialog X/Open curses . : o curses HPUX ( ) newterm . --input-fd dialog . o curses NetBSD 5.1 . dialog . (COMPATIBILITY) dialog . Dialog (Original Dialog) "" dialog ( 0.3 0.9). ( ) . dialog . : ------------------------------------------------------------------------ --beep-after --guage --gauge ------------------------------------------------------------------------ Xdialog X . Xdialog dialog . dialog Xdialog : ------------------------------------------------------------------------------- --allow-close --auto-placement --fixed-font --icon --keep-colors --no-close --no-cr-wrap --screen-center --separator --separate-output --smooth --under-mouse --wmclass ------------------------------------------------------------------------------- Xdialog dialog . . html : : Xdialog "\n" ( ) Xdialog 1.5.0 "/" cdialog . Xdialog --separate-output --checklist . Dialog . Whiptail whiptail . ( ). (README.whiptail) : whiptail(1) dialog(1) . newt ncurses . whiptail dialog : tailbox timebox calendarbox . (Debian testing 2007/1/10): whiptail newt popt slang 757 . dialog ( ncurses) 520 . . whiptail dialog gauge . whiptail dialog dialog 0.4 1990 . whiptail dialog dialog 0.4 (1994) . dialog : o --gauge ( 0.5) o --passwordbox ( 1999) o --default-item ( dialog 2000/02/22) o --output-fd ( dialog 2002/08/14). whiptail dialog . dialog whiptail : --------------------------------------------------------------------------- --cancel-button --cancel-label --fb --fullbutton --no-button --no-label --nocancel --no-cancel --noitem --no-items --notags --no-tags --ok-button --ok-label --scrolltext --scrollbar --topleft --begin 0 0 --yes-button --yes-label --------------------------------------------------------------------------- : o dialog . whiptail . o whiptail ("<" ">") . dialog . o whiptail . dialog . o whiptail / / . . dialog . (BUGS) . (EXAMPLES) dialog . samples/ . (AUTHORS) Thomas E. Dickey ( 0.9b ) Kiran Cherupally - mixed form mixed gauge. Tobias C. Rittweiler Valery Reznic - form progressbox. Yura Kalinichenko gauge "pause" . ( ) dialog 0.9a : o Savio Lam - 0.3 "dialog" o Stuart Herbert - 0.4 o Marc Ewing - gauge. o Pasquale De Marco "Pako" - 0.9a "cdialog" 2025-12-22 DIALOG()