iPXE
Data Structures | Macros | Functions
settings_ui.c File Reference

Option configuration console. More...

#include <stdio.h>
#include <stdarg.h>
#include <stdlib.h>
#include <unistd.h>
#include <string.h>
#include <curses.h>
#include <ipxe/console.h>
#include <ipxe/settings.h>
#include <ipxe/editbox.h>
#include <ipxe/keys.h>
#include <ipxe/ansicol.h>
#include <ipxe/jumpscroll.h>
#include <ipxe/settings_ui.h>
#include <config/branding.h>

Go to the source code of this file.

Data Structures

struct  settings_ui_row
 A settings user interface row. More...
 
struct  settings_ui
 A settings user interface. More...
 

Macros

#define TITLE_ROW   1U
 
#define SETTINGS_LIST_ROW   3U
 
#define SETTINGS_LIST_COL   1U
 
#define SETTINGS_LIST_ROWS   ( LINES - 6U - SETTINGS_LIST_ROW )
 
#define INFO_ROW   ( LINES - 5U )
 
#define ALERT_ROW   ( LINES - 2U )
 
#define INSTRUCTION_ROW   ( LINES - 2U )
 
#define INSTRUCTION_PAD   " "
 
#define SETTING_ROW_TEXT(cols)
 Layout of text within a setting row. More...
 

Functions

 FILE_LICENCE (GPL2_OR_LATER_OR_UBDL)
 
static unsigned int select_setting_row (struct settings_ui *ui, unsigned int index)
 Select a setting. More...
 
static size_t string_copy (char *dest, const char *src, size_t len)
 Copy string without NUL termination. More...
 
static void draw_setting_row (struct settings_ui *ui)
 Draw setting row. More...
 
static int edit_setting (struct settings_ui *ui, int key)
 Edit setting ui. More...
 
static int save_setting (struct settings_ui *ui)
 Save setting ui value back to configuration settings. More...
 
static void vmsg (unsigned int row, const char *fmt, va_list args)
 Print message centred on specified row. More...
 
static void msg (unsigned int row, const char *fmt,...)
 Print message centred on specified row. More...
 
static void clearmsg (unsigned int row)
 Clear message on specified row. More...
 
static void valert (const char *fmt, va_list args)
 Print alert message. More...
 
static void alert (const char *fmt,...)
 Print alert message. More...
 
static void draw_title_row (struct settings_ui *ui)
 Draw title row. More...
 
static void draw_info_row (struct settings_ui *ui)
 Draw information row. More...
 
static void draw_instruction_row (struct settings_ui *ui)
 Draw instruction row. More...
 
static void draw_setting_rows (struct settings_ui *ui)
 Draw the current block of setting rows. More...
 
static void select_settings (struct settings_ui *ui, struct settings *settings)
 Select settings block. More...
 
static int main_loop (struct settings *settings)
 
int settings_ui (struct settings *settings)
 

Detailed Description

Option configuration console.

Definition in file settings_ui.c.

Macro Definition Documentation

◆ TITLE_ROW

#define TITLE_ROW   1U

Definition at line 48 of file settings_ui.c.

◆ SETTINGS_LIST_ROW

#define SETTINGS_LIST_ROW   3U

Definition at line 49 of file settings_ui.c.

◆ SETTINGS_LIST_COL

#define SETTINGS_LIST_COL   1U

Definition at line 50 of file settings_ui.c.

◆ SETTINGS_LIST_ROWS

#define SETTINGS_LIST_ROWS   ( LINES - 6U - SETTINGS_LIST_ROW )

Definition at line 51 of file settings_ui.c.

◆ INFO_ROW

#define INFO_ROW   ( LINES - 5U )

Definition at line 52 of file settings_ui.c.

◆ ALERT_ROW

#define ALERT_ROW   ( LINES - 2U )

Definition at line 53 of file settings_ui.c.

◆ INSTRUCTION_ROW

#define INSTRUCTION_ROW   ( LINES - 2U )

Definition at line 54 of file settings_ui.c.

◆ INSTRUCTION_PAD

#define INSTRUCTION_PAD   " "

Definition at line 55 of file settings_ui.c.

◆ SETTING_ROW_TEXT

#define SETTING_ROW_TEXT (   cols)
Value:
struct { \
char start[0]; \
char pad1[1]; \
union { \
struct { \
char name[ cols - 1 - 1 - 1 - 1 - 1 ]; \
char pad2[1]; \
} __attribute__ (( packed )) settings; \
struct { \
char name[15]; \
char pad2[1]; \
char value[ cols - 1 - 15 - 1 - 1 - 1 - 1 ]; \
} __attribute__ (( packed )) setting; \
} u; \
char pad3[1]; \
char nul; \
} __attribute__ (( packed ))
#define __attribute__(x)
Definition: compiler.h:10
const char * name
Definition: ath9k_hw.c:1984
uint32_t start
Starting offset.
Definition: netvsc.h:12
pseudo_bit_t value[0x00020]
Definition: arbel.h:13
A settings block.
Definition: settings.h:132
A setting.
Definition: settings.h:23
union @17 u
uint16_t pad1
Unused.
Definition: bzimage.h:53
uint8_t pad2[3]
Unused.
Definition: bzimage.h:63

Layout of text within a setting row.

Definition at line 58 of file settings_ui.c.

Function Documentation

◆ FILE_LICENCE()

FILE_LICENCE ( GPL2_OR_LATER_OR_UBDL  )

◆ select_setting_row()

static unsigned int select_setting_row ( struct settings_ui ui,
unsigned int  index 
)
static

Select a setting.

Parameters
uiSettings user interface
indexIndex of setting row
Return values
countNumber of setting rows

Definition at line 120 of file settings_ui.c.

121  {
122  SETTING_ROW_TEXT ( COLS ) *text;
123  struct settings *settings;
124  struct setting *setting;
125  struct setting *previous = NULL;
126  unsigned int count = 0;
127 
128  /* Free any previous setting value */
129  free ( ui->row.buf );
130  ui->row.buf = NULL;
131 
132  /* Initialise structure */
133  memset ( &ui->row, 0, sizeof ( ui->row ) );
134  ui->row.row = ( SETTINGS_LIST_ROW + index - ui->scroll.first );
135 
136  /* Include parent settings block, if applicable */
137  if ( ui->settings->parent && ( count++ == index ) )
138  ui->row.settings = ui->settings->parent;
139 
140  /* Include any child settings blocks, if applicable */
141  list_for_each_entry ( settings, &ui->settings->children, siblings ) {
142  if ( count++ == index )
143  ui->row.settings = settings;
144  }
145 
146  /* Include any applicable settings */
148 
149  /* Skip inapplicable settings */
150  if ( ! setting_applies ( ui->settings, setting ) )
151  continue;
152 
153  /* Skip duplicate settings */
154  if ( previous && ( setting_cmp ( setting, previous ) == 0 ) )
155  continue;
156  previous = setting;
157 
158  /* Read current setting value and origin */
159  if ( count++ == index ) {
161  &ui->row.origin,
162  &ui->row.setting, &ui->row.buf );
163  }
164  }
165 
166  /* Initialise edit box */
167  init_editbox ( &ui->row.editbox, &ui->row.buf, NULL, ui->row.row,
169  offsetof ( typeof ( *text ), u.setting.value ) ),
170  sizeof ( text->u.setting.value ), 0 );
171 
172  return count;
173 }
int fetchf_setting_copy(struct settings *settings, const struct setting *setting, struct settings **origin, struct setting *fetched, char **value)
Fetch copy of formatted value of setting.
Definition: settings.c:1276
struct settings * parent
Parent settings block.
Definition: settings.h:138
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
#define SETTINGS_LIST_ROW
Definition: settings_ui.c:49
#define offsetof(type, field)
Get offset of a field within a structure.
Definition: stddef.h:24
struct settings * origin
Configuration setting origin.
Definition: settings_ui.c:87
#define SETTINGS
Configuration setting table.
Definition: settings.h:53
void init_editbox(struct edit_box *box, char **buf, WINDOW *win, unsigned int row, unsigned int col, unsigned int width, unsigned int flags)
Initialise text box widget.
Definition: editbox.c:49
#define list_for_each_entry(pos, head, member)
Iterate over entries in a list.
Definition: list.h:431
unsigned int first
First visible item.
Definition: jumpscroll.h:21
struct settings * settings
Target configuration settings block.
Definition: settings_ui.c:82
struct settings * settings
Settings block.
Definition: settings_ui.c:106
static void(* free)(struct refcnt *refcnt))
Definition: refcnt.h:54
int setting_applies(struct settings *settings, const struct setting *setting)
Check applicability of setting.
Definition: settings.c:570
#define for_each_table_entry(pointer, table)
Iterate through all entries within a linker table.
Definition: tables.h:385
A settings block.
Definition: settings.h:132
#define COLS
Definition: curses.h:111
A setting.
Definition: settings.h:23
char * buf
Dynamically allocated buffer for setting's value.
Definition: settings_ui.c:100
unsigned int row
Screen row.
Definition: settings_ui.c:94
struct setting setting
Configuration setting.
Definition: settings_ui.c:92
uint16_t count
Number of entries.
Definition: ena.h:22
struct jump_scroller scroll
Jump scroller.
Definition: settings_ui.c:108
struct edit_box editbox
Edit box widget used for editing setting.
Definition: settings_ui.c:96
#define SETTINGS_LIST_COL
Definition: settings_ui.c:50
union @17 u
struct list_head children
Child settings blocks.
Definition: settings.h:142
typeof(acpi_finder=acpi_find)
ACPI table finder.
Definition: acpi.c:45
uint64_t index
Index of the first segment within the content.
Definition: pccrc.h:21
int setting_cmp(const struct setting *a, const struct setting *b)
Compare two settings.
Definition: settings.c:1120
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
#define SETTING_ROW_TEXT(cols)
Layout of text within a setting row.
Definition: settings_ui.c:58
void * memset(void *dest, int character, size_t len) __nonnull

References settings_ui_row::buf, settings::children, COLS, count, settings_ui_row::editbox, fetchf_setting_copy(), jump_scroller::first, for_each_table_entry, free, index, init_editbox(), list_for_each_entry, memset(), NULL, offsetof, settings_ui_row::origin, settings::parent, settings_ui_row::row, settings_ui::row, settings_ui::scroll, settings_ui_row::setting, setting_applies(), setting_cmp(), SETTING_ROW_TEXT, SETTINGS, settings_ui_row::settings, settings_ui::settings, SETTINGS_LIST_COL, SETTINGS_LIST_ROW, typeof(), and u.

Referenced by draw_setting_rows(), main_loop(), and select_settings().

◆ string_copy()

static size_t string_copy ( char *  dest,
const char *  src,
size_t  len 
)
static

Copy string without NUL termination.

Parameters
destDestination
srcSource
lenMaximum length of destination
Return values
lenLength of (unterminated) string

Definition at line 183 of file settings_ui.c.

183  {
184  size_t src_len;
185 
186  src_len = strlen ( src );
187  if ( len > src_len )
188  len = src_len;
189  memcpy ( dest, src, len );
190  return len;
191 }
static void const void * src
Definition: crypto.h:244
void * memcpy(void *dest, const void *src, size_t len) __nonnull
static void * dest
Definition: strings.h:176
size_t strlen(const char *src)
Get length of string.
Definition: string.c:243
uint32_t len
Length.
Definition: ena.h:14

References dest, len, memcpy(), src, and strlen().

Referenced by draw_setting_row().

◆ draw_setting_row()

static void draw_setting_row ( struct settings_ui ui)
static

Draw setting row.

Parameters
uiSettings UI

Definition at line 198 of file settings_ui.c.

198  {
199  SETTING_ROW_TEXT ( COLS ) text;
200  unsigned int curs_offset;
201  const char *value;
202 
203  /* Fill row with spaces */
204  memset ( &text, ' ', sizeof ( text ) );
205  text.nul = '\0';
206 
207  /* Construct row content */
208  if ( ui->row.settings ) {
209 
210  /* Construct space-padded name */
211  value = ( ( ui->row.settings == ui->settings->parent ) ?
212  ".." : ui->row.settings->name );
213  curs_offset = string_copy ( text.u.settings.name, value,
214  sizeof ( text.u.settings.name ) );
215  text.u.settings.name[curs_offset] = '/';
216  curs_offset += offsetof ( typeof ( text ), u.settings );
217 
218  } else {
219 
220  /* Construct dot-padded name */
221  memset ( text.u.setting.name, '.',
222  sizeof ( text.u.setting.name ) );
223  string_copy ( text.u.setting.name, ui->row.setting.name,
224  sizeof ( text.u.setting.name ) );
225 
226  /* Construct space-padded value */
227  value = ui->row.buf;
228  if ( ! ( value && value[0] ) )
229  value = "<not specified>";
230  curs_offset = string_copy ( text.u.setting.value, value,
231  sizeof ( text.u.setting.value ) );
232  curs_offset += offsetof ( typeof ( text ), u.setting.value );
233  }
234 
235  /* Print row */
236  if ( ( ui->row.origin == ui->settings ) || ( ui->row.settings != NULL ))
237  attron ( A_BOLD );
238  mvprintw ( ui->row.row, SETTINGS_LIST_COL, "%s", text.start );
239  attroff ( A_BOLD );
240  move ( ui->row.row, ( SETTINGS_LIST_COL + curs_offset ) );
241 }
struct settings * parent
Parent settings block.
Definition: settings.h:138
static int attroff(int attrs)
Definition: curses.h:508
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
#define mvprintw(y, x, fmt,...)
Definition: curses.h:648
#define offsetof(type, field)
Get offset of a field within a structure.
Definition: stddef.h:24
struct settings * origin
Configuration setting origin.
Definition: settings_ui.c:87
const char * name
Name.
Definition: settings.h:28
struct settings * settings
Target configuration settings block.
Definition: settings_ui.c:82
pseudo_bit_t value[0x00020]
Definition: arbel.h:13
struct settings * settings
Settings block.
Definition: settings_ui.c:106
const char * name
Name.
Definition: settings.h:136
#define COLS
Definition: curses.h:111
char * buf
Dynamically allocated buffer for setting's value.
Definition: settings_ui.c:100
unsigned int row
Screen row.
Definition: settings_ui.c:94
struct setting setting
Configuration setting.
Definition: settings_ui.c:92
static int move(int y, int x)
Definition: curses.h:593
#define SETTINGS_LIST_COL
Definition: settings_ui.c:50
union @17 u
typeof(acpi_finder=acpi_find)
ACPI table finder.
Definition: acpi.c:45
#define A_BOLD
Definition: curses.h:138
static size_t string_copy(char *dest, const char *src, size_t len)
Copy string without NUL termination.
Definition: settings_ui.c:183
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
#define SETTING_ROW_TEXT(cols)
Layout of text within a setting row.
Definition: settings_ui.c:58
static int attron(int attrs)
Definition: curses.h:512
void * memset(void *dest, int character, size_t len) __nonnull

References A_BOLD, attroff(), attron(), settings_ui_row::buf, COLS, memset(), move(), mvprintw, setting::name, settings::name, NULL, offsetof, settings_ui_row::origin, settings::parent, settings_ui_row::row, settings_ui::row, settings_ui_row::setting, SETTING_ROW_TEXT, settings_ui_row::settings, settings_ui::settings, SETTINGS_LIST_COL, string_copy(), typeof(), u, and value.

Referenced by draw_setting_rows(), and main_loop().

◆ edit_setting()

static int edit_setting ( struct settings_ui ui,
int  key 
)
static

Edit setting ui.

Parameters
uiSettings UI
keyKey pressed by user
Return values
keyKey returned to application, or zero

Definition at line 250 of file settings_ui.c.

250  {
251  assert ( ui->row.setting.name != NULL );
252  ui->row.editing = 1;
253  return edit_editbox ( &ui->row.editbox, key );
254 }
int editing
Editing in progress flag.
Definition: settings_ui.c:98
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
const char * name
Name.
Definition: settings.h:28
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
static int edit_editbox(struct edit_box *box, int key) __nonnull
Edit text box widget.
Definition: editbox.h:57
struct setting setting
Configuration setting.
Definition: settings_ui.c:92
struct edit_box editbox
Edit box widget used for editing setting.
Definition: settings_ui.c:96
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
union @382 key
Sense key.
Definition: crypto.h:284

References assert(), edit_editbox(), settings_ui_row::editbox, settings_ui_row::editing, key, setting::name, NULL, settings_ui::row, and settings_ui_row::setting.

Referenced by main_loop().

◆ save_setting()

static int save_setting ( struct settings_ui ui)
static

Save setting ui value back to configuration settings.

Parameters
uiSettings UI

Definition at line 261 of file settings_ui.c.

261  {
262  assert ( ui->row.setting.name != NULL );
263  return storef_setting ( ui->settings, &ui->row.setting, ui->row.buf );
264 }
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
const char * name
Name.
Definition: settings.h:28
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
int storef_setting(struct settings *settings, const struct setting *setting, const char *value)
Store formatted value of setting.
Definition: settings.c:1319
struct settings * settings
Settings block.
Definition: settings_ui.c:106
char * buf
Dynamically allocated buffer for setting's value.
Definition: settings_ui.c:100
struct setting setting
Configuration setting.
Definition: settings_ui.c:92
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321

References assert(), settings_ui_row::buf, setting::name, NULL, settings_ui::row, settings_ui_row::setting, settings_ui::settings, and storef_setting().

Referenced by main_loop().

◆ vmsg()

static void vmsg ( unsigned int  row,
const char *  fmt,
va_list  args 
)
static

Print message centred on specified row.

Parameters
rowRow
fmtprintf() format string
argsprintf() argument list

Definition at line 273 of file settings_ui.c.

273  {
274  char buf[COLS];
275  size_t len;
276 
277  len = vsnprintf ( buf, sizeof ( buf ), fmt, args );
278  mvprintw ( row, ( ( COLS - len ) / 2 ), "%s", buf );
279 }
#define mvprintw(y, x, fmt,...)
Definition: curses.h:648
#define COLS
Definition: curses.h:111
uint32_t len
Length.
Definition: ena.h:14
int ssize_t const char * fmt
Definition: vsprintf.h:72
int vsnprintf(char *buf, size_t size, const char *fmt, va_list args)
Write a formatted string to a buffer.
Definition: vsprintf.c:351

References COLS, fmt, len, mvprintw, and vsnprintf().

Referenced by msg(), and valert().

◆ msg()

static void msg ( unsigned int  row,
const char *  fmt,
  ... 
)
static

Print message centred on specified row.

Parameters
rowRow
fmtprintf() format string
..printf() arguments

Definition at line 288 of file settings_ui.c.

288  {
289  va_list args;
290 
291  va_start ( args, fmt );
292  vmsg ( row, fmt, args );
293  va_end ( args );
294 }
#define va_end(ap)
Definition: stdarg.h:9
static void vmsg(unsigned int row, const char *fmt, va_list args)
Print message centred on specified row.
Definition: settings_ui.c:273
__builtin_va_list va_list
Definition: stdarg.h:6
int ssize_t const char * fmt
Definition: vsprintf.h:72
#define va_start(ap, last)
Definition: stdarg.h:7

References fmt, va_end, va_start, and vmsg().

Referenced by ccmp_kie_decrypt(), ccmp_kie_mic(), draw_info_row(), draw_instruction_row(), draw_title_row(), eap_rx_request(), eap_tx_response(), hv_post_message(), hv_wait_for_message(), igbvf_read_mbx_vf(), igbvf_read_posted_mbx(), igbvf_write_mbx_vf(), igbvf_write_posted_mbx(), intelvf_mbox_msg(), intelvf_mbox_poll(), intelvf_mbox_read(), intelvf_mbox_reset(), intelvf_mbox_set_mac(), intelvf_mbox_set_mtu(), intelvf_mbox_write(), intelxvf_mbox_queues(), intelxvf_mbox_version(), ipair_key(), ipair_rx(), ipair_rx_pair(), ipair_rx_pubkey(), ipair_rx_session(), ipair_tag(), ipair_tx(), netvsc_establish_buffer(), netvsc_initialise(), netvsc_ndis_version(), netvsc_recv_data(), netvsc_revoke_buffer(), netvsc_transmit(), ntlm_data_okx(), peerblk_parse_block(), peerblk_parse_header(), peerblk_parse_iv(), peerblk_parse_useless(), peerblk_retrieval_open(), reg_delay(), rndis_rx_data(), rndis_rx_status(), rndis_tx_data(), rndis_tx_defer(), rndis_tx_halt(), rndis_tx_initialise(), rndis_tx_oid(), sis190_phy_task(), tkip_kie_decrypt(), tkip_kie_mic(), usbio_config(), usbio_control_poll(), xcm_deliver(), xenstore_request(), xenstore_response(), xsmp_chassis_name(), xsmp_rx_session(), xsmp_rx_session_confirm(), xsmp_rx_session_reject(), xsmp_rx_session_shutdown(), xsmp_rx_xve(), xsmp_rx_xve_delete(), xsmp_rx_xve_install(), xsmp_rx_xve_modify(), xsmp_rx_xve_oper_req(), xsmp_rx_xve_ready(), xsmp_rx_xve_update(), xsmp_session_name(), xsmp_tx_session(), xsmp_tx_xve(), xsmp_tx_xve_nack(), xsmp_tx_xve_notify(), and xsmp_tx_xve_params().

◆ clearmsg()

static void clearmsg ( unsigned int  row)
static

Clear message on specified row.

Parameters
rowRow

Definition at line 301 of file settings_ui.c.

301  {
302  move ( row, 0 );
303  clrtoeol();
304 }
static int clrtoeol(void)
Definition: curses.h:553
static int move(int y, int x)
Definition: curses.h:593

References clrtoeol(), and move().

Referenced by draw_info_row(), draw_instruction_row(), draw_setting_rows(), draw_title_row(), and valert().

◆ valert()

static void valert ( const char *  fmt,
va_list  args 
)
static

Print alert message.

Parameters
fmtprintf() format string
argsprintf() argument list

Definition at line 312 of file settings_ui.c.

312  {
313  clearmsg ( ALERT_ROW );
315  vmsg ( ALERT_ROW, fmt, args );
316  sleep ( 2 );
318  clearmsg ( ALERT_ROW );
319 }
static void clearmsg(unsigned int row)
Clear message on specified row.
Definition: settings_ui.c:301
#define CPAIR_NORMAL
Normal text.
Definition: ansicol.h:40
#define CPAIR_ALERT
Error text.
Definition: ansicol.h:52
#define ALERT_ROW
Definition: settings_ui.c:53
static void vmsg(unsigned int row, const char *fmt, va_list args)
Print message centred on specified row.
Definition: settings_ui.c:273
int ssize_t const char * fmt
Definition: vsprintf.h:72
#define color_set(cpno, opts)
Definition: curses.h:240
unsigned int sleep(unsigned int secs)
Sleep (interruptibly) for a fixed number of seconds.
Definition: timer.c:133
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321

References ALERT_ROW, clearmsg(), color_set, CPAIR_ALERT, CPAIR_NORMAL, fmt, NULL, sleep(), and vmsg().

Referenced by alert().

◆ alert()

static void alert ( const char *  fmt,
  ... 
)
static

Print alert message.

Parameters
fmtprintf() format string
...printf() arguments

Definition at line 327 of file settings_ui.c.

327  {
328  va_list args;
329 
330  va_start ( args, fmt );
331  valert ( fmt, args );
332  va_end ( args );
333 }
#define va_end(ap)
Definition: stdarg.h:9
static void valert(const char *fmt, va_list args)
Print alert message.
Definition: settings_ui.c:312
__builtin_va_list va_list
Definition: stdarg.h:6
int ssize_t const char * fmt
Definition: vsprintf.h:72
#define va_start(ap, last)
Definition: stdarg.h:7

References fmt, va_end, va_start, and valert().

Referenced by main_loop(), and tls_new_alert().

◆ draw_title_row()

static void draw_title_row ( struct settings_ui ui)
static

Draw title row.

Parameters
uiSettings UI

Definition at line 340 of file settings_ui.c.

340  {
341  const char *name;
342 
343  clearmsg ( TITLE_ROW );
344  name = settings_name ( ui->settings );
345  attron ( A_BOLD );
346  msg ( TITLE_ROW, PRODUCT_SHORT_NAME " configuration settings%s%s",
347  ( name[0] ? " - " : "" ), name );
348  attroff ( A_BOLD );
349 }
const char * name
Definition: ath9k_hw.c:1984
#define PRODUCT_SHORT_NAME
Definition: branding.h:28
static int attroff(int attrs)
Definition: curses.h:508
static void clearmsg(unsigned int row)
Clear message on specified row.
Definition: settings_ui.c:301
const char * settings_name(struct settings *settings)
Return settings block name.
Definition: settings.c:345
#define TITLE_ROW
Definition: settings_ui.c:48
struct settings * settings
Settings block.
Definition: settings_ui.c:106
#define A_BOLD
Definition: curses.h:138
static int attron(int attrs)
Definition: curses.h:512
static void msg(unsigned int row, const char *fmt,...)
Print message centred on specified row.
Definition: settings_ui.c:288

References A_BOLD, attroff(), attron(), clearmsg(), msg(), name, PRODUCT_SHORT_NAME, settings_ui::settings, settings_name(), and TITLE_ROW.

Referenced by select_settings().

◆ draw_info_row()

static void draw_info_row ( struct settings_ui ui)
static

Draw information row.

Parameters
uiSettings UI

Definition at line 356 of file settings_ui.c.

356  {
357  char buf[32];
358 
359  /* Draw nothing unless this row represents a setting */
360  clearmsg ( INFO_ROW );
361  clearmsg ( INFO_ROW + 1 );
362  if ( ! ui->row.setting.name )
363  return;
364 
365  /* Determine a suitable setting name */
366  setting_name ( ( ui->row.origin ?
367  ui->row.origin : ui->settings ),
368  &ui->row.setting, buf, sizeof ( buf ) );
369 
370  /* Draw row */
371  attron ( A_BOLD );
372  msg ( INFO_ROW, "%s - %s", buf, ui->row.setting.description );
373  attroff ( A_BOLD );
374  color_set ( CPAIR_URL, NULL );
375  msg ( ( INFO_ROW + 1 ), PRODUCT_SETTING_URI, ui->row.setting.name );
377 }
static int attroff(int attrs)
Definition: curses.h:508
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
static void clearmsg(unsigned int row)
Clear message on specified row.
Definition: settings_ui.c:301
const char * description
Description.
Definition: settings.h:30
#define CPAIR_NORMAL
Normal text.
Definition: ansicol.h:40
struct settings * origin
Configuration setting origin.
Definition: settings_ui.c:87
const char * name
Name.
Definition: settings.h:28
#define PRODUCT_SETTING_URI
Definition: branding.h:170
#define CPAIR_URL
URL text.
Definition: ansicol.h:55
struct settings * settings
Settings block.
Definition: settings_ui.c:106
#define INFO_ROW
Definition: settings_ui.c:52
struct setting setting
Configuration setting.
Definition: settings_ui.c:92
#define color_set(cpno, opts)
Definition: curses.h:240
#define A_BOLD
Definition: curses.h:138
int setting_name(struct settings *settings, const struct setting *setting, char *buf, size_t len)
Return full setting name.
Definition: settings.c:1606
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
static int attron(int attrs)
Definition: curses.h:512
static void msg(unsigned int row, const char *fmt,...)
Print message centred on specified row.
Definition: settings_ui.c:288

References A_BOLD, attroff(), attron(), clearmsg(), color_set, CPAIR_NORMAL, CPAIR_URL, setting::description, INFO_ROW, msg(), setting::name, NULL, settings_ui_row::origin, PRODUCT_SETTING_URI, settings_ui::row, settings_ui_row::setting, setting_name(), and settings_ui::settings.

Referenced by main_loop().

◆ draw_instruction_row()

static void draw_instruction_row ( struct settings_ui ui)
static

Draw instruction row.

Parameters
uiSettings UI

Definition at line 384 of file settings_ui.c.

384  {
385 
387  if ( ui->row.editing ) {
389  "Enter - accept changes" INSTRUCTION_PAD
390  "Ctrl-C - discard changes" );
391  } else {
393  "%sCtrl-X - exit configuration utility",
394  ( ( ui->row.origin == ui->settings ) ?
395  "Ctrl-D - delete setting" INSTRUCTION_PAD : "" ) );
396  }
397 }
int editing
Editing in progress flag.
Definition: settings_ui.c:98
struct settings_ui_row row
Current row.
Definition: settings_ui.c:110
static void clearmsg(unsigned int row)
Clear message on specified row.
Definition: settings_ui.c:301
struct settings * origin
Configuration setting origin.
Definition: settings_ui.c:87
struct settings * settings
Settings block.
Definition: settings_ui.c:106
#define INSTRUCTION_ROW
Definition: settings_ui.c:54
#define INSTRUCTION_PAD
Definition: settings_ui.c:55
static void msg(unsigned int row, const char *fmt,...)
Print message centred on specified row.
Definition: settings_ui.c:288

References clearmsg(), settings_ui_row::editing, INSTRUCTION_PAD, INSTRUCTION_ROW, msg(), settings_ui_row::origin, settings_ui::row, and settings_ui::settings.

Referenced by main_loop().

◆ draw_setting_rows()

static void draw_setting_rows ( struct settings_ui ui)
static

Draw the current block of setting rows.

Parameters
uiSettings UI

Definition at line 404 of file settings_ui.c.

404  {
405  unsigned int i;
406 
407  /* Draw ellipses before and/or after the list as necessary */
409  mvaddstr ( ( SETTINGS_LIST_ROW - 1 ), ( SETTINGS_LIST_COL + 1 ),
410  jump_scroll_is_first ( &ui->scroll ) ? " " : "..." );
412  ( SETTINGS_LIST_COL + 1 ),
413  jump_scroll_is_last ( &ui->scroll ) ? " " : "..." );
415 
416  /* Draw visible settings. */
417  for ( i = 0 ; i < SETTINGS_LIST_ROWS ; i++ ) {
418  if ( ( ui->scroll.first + i ) < ui->scroll.count ) {
419  select_setting_row ( ui, ( ui->scroll.first + i ) );
420  draw_setting_row ( ui );
421  } else {
422  clearmsg ( SETTINGS_LIST_ROW + i );
423  }
424  }
425 }
static void draw_setting_row(struct settings_ui *ui)
Draw setting row.
Definition: settings_ui.c:198
static void clearmsg(unsigned int row)
Clear message on specified row.
Definition: settings_ui.c:301
#define SETTINGS_LIST_ROW
Definition: settings_ui.c:49
static unsigned int select_setting_row(struct settings_ui *ui, unsigned int index)
Select a setting.
Definition: settings_ui.c:120
#define CPAIR_NORMAL
Normal text.
Definition: ansicol.h:40
unsigned int first
First visible item.
Definition: jumpscroll.h:21
unsigned int count
Total number of items.
Definition: jumpscroll.h:17
#define CPAIR_SEPARATOR
Unselectable text (e.g.
Definition: ansicol.h:46
static int jump_scroll_is_last(struct jump_scroller *scroll)
Check if jump scroller is currently on last page.
Definition: jumpscroll.h:41
struct jump_scroller scroll
Jump scroller.
Definition: settings_ui.c:108
static int jump_scroll_is_first(struct jump_scroller *scroll)
Check if jump scroller is currently on first page.
Definition: jumpscroll.h:30
#define SETTINGS_LIST_COL
Definition: settings_ui.c:50
#define color_set(cpno, opts)
Definition: curses.h:240
#define SETTINGS_LIST_ROWS
Definition: settings_ui.c:51
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
static int mvaddstr(int y, int x, const char *str)
Definition: curses.h:617

References clearmsg(), color_set, jump_scroller::count, CPAIR_NORMAL, CPAIR_SEPARATOR, draw_setting_row(), jump_scroller::first, jump_scroll_is_first(), jump_scroll_is_last(), mvaddstr(), NULL, settings_ui::scroll, select_setting_row(), SETTINGS_LIST_COL, SETTINGS_LIST_ROW, and SETTINGS_LIST_ROWS.

Referenced by main_loop(), and select_settings().

◆ select_settings()

static void select_settings ( struct settings_ui ui,
struct settings settings 
)
static

Select settings block.

Parameters
uiSettings UI
settingsSettings block

Definition at line 433 of file settings_ui.c.

434  {
435 
437  ui->scroll.count = select_setting_row ( ui, 0 );
439  ui->scroll.current = 0;
440  ui->scroll.first = 0;
441  draw_title_row ( ui );
442  draw_setting_rows ( ui );
443  select_setting_row ( ui, 0 );
444 }
static unsigned int select_setting_row(struct settings_ui *ui, unsigned int index)
Select a setting.
Definition: settings_ui.c:120
struct settings * settings_target(struct settings *settings)
Redirect to target settings block.
Definition: settings.c:549
static void draw_setting_rows(struct settings_ui *ui)
Draw the current block of setting rows.
Definition: settings_ui.c:404
unsigned int first
First visible item.
Definition: jumpscroll.h:21
unsigned int count
Total number of items.
Definition: jumpscroll.h:17
struct settings * settings
Settings block.
Definition: settings_ui.c:106
A settings block.
Definition: settings.h:132
struct jump_scroller scroll
Jump scroller.
Definition: settings_ui.c:108
unsigned int rows
Maximum number of visible rows.
Definition: jumpscroll.h:15
static void draw_title_row(struct settings_ui *ui)
Draw title row.
Definition: settings_ui.c:340
unsigned int current
Currently selected item.
Definition: jumpscroll.h:19
#define SETTINGS_LIST_ROWS
Definition: settings_ui.c:51

References jump_scroller::count, jump_scroller::current, draw_setting_rows(), draw_title_row(), jump_scroller::first, jump_scroller::rows, settings_ui::scroll, select_setting_row(), settings_ui::settings, SETTINGS_LIST_ROWS, and settings_target().

Referenced by main_loop().

◆ main_loop()

static int main_loop ( struct settings settings)
static

Definition at line 446 of file settings_ui.c.

446  {
447  struct settings_ui ui;
448  unsigned int previous;
449  int redraw = 1;
450  int move;
451  int key;
452  int rc;
453 
454  /* Print initial screen content */
456  memset ( &ui, 0, sizeof ( ui ) );
457  select_settings ( &ui, settings );
458 
459  while ( 1 ) {
460 
461  /* Redraw rows if necessary */
462  if ( redraw ) {
463  draw_info_row ( &ui );
464  draw_instruction_row ( &ui );
465  color_set ( ( ui.row.editing ?
467  draw_setting_row ( &ui );
469  curs_set ( ui.row.editing );
470  redraw = 0;
471  }
472 
473  /* Edit setting, if we are currently editing */
474  if ( ui.row.editing ) {
475 
476  /* Sanity check */
477  assert ( ui.row.setting.name != NULL );
478 
479  /* Redraw edit box */
481  draw_editbox ( &ui.row.editbox );
483 
484  /* Process keypress */
485  key = edit_setting ( &ui, getkey ( 0 ) );
486  switch ( key ) {
487  case CR:
488  case LF:
489  if ( ( rc = save_setting ( &ui ) ) != 0 )
490  alert ( " %s ", strerror ( rc ) );
491  /* Fall through */
492  case CTRL_C:
493  select_setting_row ( &ui, ui.scroll.current );
494  redraw = 1;
495  break;
496  default:
497  /* Do nothing */
498  break;
499  }
500 
501  continue;
502  }
503 
504  /* Otherwise, navigate through settings */
505  key = getkey ( 0 );
506  move = jump_scroll_key ( &ui.scroll, key );
507  if ( move ) {
508  previous = ui.scroll.current;
509  jump_scroll_move ( &ui.scroll, move );
510  if ( ui.scroll.current != previous ) {
511  draw_setting_row ( &ui );
512  redraw = 1;
513  if ( jump_scroll ( &ui.scroll ) )
514  draw_setting_rows ( &ui );
515  select_setting_row ( &ui, ui.scroll.current );
516  }
517  continue;
518  }
519 
520  /* Handle non-navigation keys */
521  switch ( key ) {
522  case CTRL_D:
523  if ( ! ui.row.setting.name )
524  break;
525  if ( ( rc = delete_setting ( ui.settings,
526  &ui.row.setting ) ) != 0 ){
527  alert ( " %s ", strerror ( rc ) );
528  }
529  select_setting_row ( &ui, ui.scroll.current );
530  redraw = 1;
531  break;
532  case CTRL_X:
533  select_setting_row ( &ui, -1U );
534  return 0;
535  case CR:
536  case LF:
537  if ( ui.row.settings ) {
538  select_settings ( &ui, ui.row.settings );
539  redraw = 1;
540  }
541  /* Fall through */
542  default:
543  if ( ui.row.setting.name ) {
544  edit_setting ( &ui, key );
545  redraw = 1;
546  }
547  break;
548  }
549  }
550 }
int getkey(unsigned long timeout)
Get single keypress.
Definition: getkey.c:71
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
static void draw_setting_row(struct settings_ui *ui)
Draw setting row.
Definition: settings_ui.c:198
#define CPAIR_EDIT
Editable text.
Definition: ansicol.h:49
A settings user interface.
Definition: settings_ui.c:104
static int delete_setting(struct settings *settings, const struct setting *setting)
Delete setting.
Definition: settings.h:531
static void draw_instruction_row(struct settings_ui *ui)
Draw instruction row.
Definition: settings_ui.c:384
static unsigned int select_setting_row(struct settings_ui *ui, unsigned int index)
Select a setting.
Definition: settings_ui.c:120
#define CPAIR_NORMAL
Normal text.
Definition: ansicol.h:40
#define CTRL_X
Definition: keys.h:41
static int save_setting(struct settings_ui *ui)
Save setting ui value back to configuration settings.
Definition: settings_ui.c:261
static void draw_setting_rows(struct settings_ui *ui)
Draw the current block of setting rows.
Definition: settings_ui.c:404
static void draw_info_row(struct settings_ui *ui)
Draw information row.
Definition: settings_ui.c:356
assert((readw(&hdr->flags) &(GTF_reading|GTF_writing))==0)
int jump_scroll(struct jump_scroller *scroll)
Jump scroll to new page (if applicable)
Definition: jumpscroll.c:119
#define CTRL_C
Definition: keys.h:20
char * strerror(int errno)
Retrieve string representation of error number.
Definition: strerror.c:78
static void select_settings(struct settings_ui *ui, struct settings *settings)
Select settings block.
Definition: settings_ui.c:433
A settings block.
Definition: settings.h:132
#define LF
Definition: keys.h:47
void draw_editbox(struct edit_box *box)
Draw text box widget.
Definition: editbox.c:68
int curs_set(int visibility)
Set cursor visibility.
Definition: mucurses.c:153
static void alert(const char *fmt,...)
Print alert message.
Definition: settings_ui.c:327
static int move(int y, int x)
Definition: curses.h:593
#define CPAIR_SELECT
Highlighted text.
Definition: ansicol.h:43
int jump_scroll_key(struct jump_scroller *scroll, int key)
Jump scrolling.
Definition: jumpscroll.c:42
#define CR
Definition: keys.h:48
#define color_set(cpno, opts)
Definition: curses.h:240
#define CTRL_D
Definition: keys.h:21
static int edit_setting(struct settings_ui *ui, int key)
Edit setting ui.
Definition: settings_ui.c:250
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321
union @382 key
Sense key.
Definition: crypto.h:284
int jump_scroll_move(struct jump_scroller *scroll, int move)
Move scroller.
Definition: jumpscroll.c:78
void * memset(void *dest, int character, size_t len) __nonnull

References alert(), assert(), color_set, CPAIR_EDIT, CPAIR_NORMAL, CPAIR_SELECT, CR, CTRL_C, CTRL_D, CTRL_X, jump_scroller::current, curs_set(), delete_setting(), draw_editbox(), draw_info_row(), draw_instruction_row(), draw_setting_row(), draw_setting_rows(), edit_setting(), settings_ui_row::editbox, settings_ui_row::editing, getkey(), jump_scroll(), jump_scroll_key(), jump_scroll_move(), key, LF, memset(), move(), setting::name, NULL, rc, settings_ui::row, save_setting(), settings_ui::scroll, select_setting_row(), select_settings(), settings_ui_row::setting, settings_ui_row::settings, settings_ui::settings, and strerror().

Referenced by settings_ui().

◆ settings_ui()

int settings_ui ( struct settings settings)

Definition at line 552 of file settings_ui.c.

552  {
553  int rc;
554 
555  initscr();
556  start_color();
558  curs_set ( 0 );
559  erase();
560 
561  rc = main_loop ( settings );
562 
563  endwin();
564 
565  return rc;
566 }
struct arbelprm_rc_send_wqe rc
Definition: arbel.h:14
int erase(void)
Completely clear the screen.
Definition: clear.c:97
static int main_loop(struct settings *settings)
Definition: settings_ui.c:446
#define start_color()
Definition: curses.h:396
int endwin(void)
Finalise console environment.
Definition: wininit.c:31
#define CPAIR_NORMAL
Normal text.
Definition: ansicol.h:40
WINDOW * initscr(void)
Initialise console environment.
Definition: wininit.c:17
A settings block.
Definition: settings.h:132
int curs_set(int visibility)
Set cursor visibility.
Definition: mucurses.c:153
#define color_set(cpno, opts)
Definition: curses.h:240
#define NULL
NULL pointer (VOID *)
Definition: Base.h:321

References color_set, CPAIR_NORMAL, curs_set(), endwin(), erase(), initscr(), main_loop(), NULL, rc, and start_color.