/[LeafOK_CVS]/lbbs/src/menu.c
ViewVC logotype

Diff of /lbbs/src/menu.c

Parent Directory Parent Directory | Revision Log Revision Log | View Patch Patch

Revision 1.42 by sysadm, Thu May 15 08:53:23 2025 UTC Revision 1.76 by sysadm, Sat Oct 18 13:23:50 2025 UTC
# Line 16  Line 16 
16    
17  #include "bbs.h"  #include "bbs.h"
18  #include "bbs_cmd.h"  #include "bbs_cmd.h"
 #include "user_priv.h"  
19  #include "bbs_cmd.h"  #include "bbs_cmd.h"
20  #include "menu.h"  #include "common.h"
 #include "log.h"  
21  #include "io.h"  #include "io.h"
22    #include "log.h"
23    #include "menu.h"
24  #include "screen.h"  #include "screen.h"
25  #include "common.h"  #include "user_priv.h"
 #include <string.h>  
 #include <stdio.h>  
26  #include <ctype.h>  #include <ctype.h>
 #include <stdlib.h>  
27  #include <errno.h>  #include <errno.h>
28    #include <stdio.h>
29    #include <stdlib.h>
30    #include <string.h>
31  #include <unistd.h>  #include <unistd.h>
 #include <sys/shm.h>  
32  #include <sys/ipc.h>  #include <sys/ipc.h>
33    #include <sys/shm.h>
34    
35  #define MENU_SCREEN_PATH_PREFIX "var/MENU_SCR_"  #define MENU_SCREEN_PATH_PREFIX "var/MENU_SCR_"
36  #define MENU_CONF_DELIM_WITH_SPACE " ,\t\r\n"  #define MENU_CONF_DELIM_WITH_SPACE " ,\t\r\n"
# Line 38  Line 38 
38    
39  #define MENU_SET_RESERVED_LENGTH (sizeof(int16_t) * 4)  #define MENU_SET_RESERVED_LENGTH (sizeof(int16_t) * 4)
40    
41  MENU_SET *p_bbs_menu;  MENU_SET bbs_menu;
42    MENU_SET top10_menu;
43    
44  int load_menu(MENU_SET *p_menu_set, const char *conf_file)  int load_menu(MENU_SET *p_menu_set, const char *conf_file)
45  {  {
# Line 48  int load_menu(MENU_SET *p_menu_set, cons Line 49  int load_menu(MENU_SET *p_menu_set, cons
49          char temp[LINE_BUFFER_LEN];          char temp[LINE_BUFFER_LEN];
50          char *p = NULL;          char *p = NULL;
51          char *q = NULL;          char *q = NULL;
52            char *r = NULL;
53          char *saveptr = NULL;          char *saveptr = NULL;
54          MENU *p_menu = NULL;          MENU *p_menu = NULL;
55          MENU_ITEM *p_menu_item = NULL;          MENU_ITEM *p_menu_item = NULL;
# Line 59  int load_menu(MENU_SET *p_menu_set, cons Line 61  int load_menu(MENU_SET *p_menu_set, cons
61          key_t key;          key_t key;
62          size_t size;          size_t size;
63    
64            // Initialize the data structure
65            memset(p_menu_set, 0, sizeof(*p_menu_set));
66    
67          // Use trie_dict to search menu_id by menu name          // Use trie_dict to search menu_id by menu name
68          p_menu_set->p_menu_name_dict = trie_dict_create();          p_menu_set->p_menu_name_dict = trie_dict_create();
69          if (p_menu_set->p_menu_name_dict == NULL)          if (p_menu_set->p_menu_name_dict == NULL)
# Line 77  int load_menu(MENU_SET *p_menu_set, cons Line 82  int load_menu(MENU_SET *p_menu_set, cons
82    
83          if ((fin = fopen(conf_file, "r")) == NULL)          if ((fin = fopen(conf_file, "r")) == NULL)
84          {          {
85                  log_error("Open %s failed", conf_file);                  log_error("Open %s failed\n", conf_file);
86                  return -2;                  return -2;
87          }          }
88    
# Line 98  int load_menu(MENU_SET *p_menu_set, cons Line 103  int load_menu(MENU_SET *p_menu_set, cons
103          p_menu_set->shmid = shmget(key, size, IPC_CREAT | IPC_EXCL | 0600);          p_menu_set->shmid = shmget(key, size, IPC_CREAT | IPC_EXCL | 0600);
104          if (p_menu_set->shmid == -1)          if (p_menu_set->shmid == -1)
105          {          {
106                  log_error("shmget(size = %d) error (%d)\n", size, errno);                  log_error("shmget(conf_file=%s, proj_id=%d, key=%d, size=%d) error (%d)\n",
107                                      conf_file, proj_id, key, size, errno);
108                  return -3;                  return -3;
109          }          }
110          p_menu_set->p_reserved = shmat(p_menu_set->shmid, NULL, 0);          p_menu_set->p_reserved = shmat(p_menu_set->shmid, NULL, 0);
# Line 107  int load_menu(MENU_SET *p_menu_set, cons Line 113  int load_menu(MENU_SET *p_menu_set, cons
113                  log_error("shmat() error (%d)\n", errno);                  log_error("shmat() error (%d)\n", errno);
114                  return -3;                  return -3;
115          }          }
116          p_menu_set->p_menu_pool = p_menu_set->p_reserved + MENU_SET_RESERVED_LENGTH;          p_menu_set->p_menu_pool = (char *)(p_menu_set->p_reserved) + MENU_SET_RESERVED_LENGTH;
117          p_menu_set->p_menu_item_pool = p_menu_set->p_menu_pool + sizeof(MENU) * MAX_MENUS;          p_menu_set->p_menu_item_pool = (char *)(p_menu_set->p_menu_pool) + sizeof(MENU) * MAX_MENUS;
118          p_menu_set->p_menu_screen_pool = p_menu_set->p_menu_item_pool + sizeof(MENU_ITEM) * MAX_MENUITEMS;          p_menu_set->p_menu_screen_pool = (char *)(p_menu_set->p_menu_item_pool) + sizeof(MENU_ITEM) * MAX_MENUITEMS;
119          p_menu_set->p_menu_screen_buf = p_menu_set->p_menu_screen_pool + sizeof(MENU_SCREEN) * MAX_MENUS;          p_menu_set->p_menu_screen_buf = (char *)(p_menu_set->p_menu_screen_pool) + sizeof(MENU_SCREEN) * MAX_MENUS;
120          p_menu_set->p_menu_screen_buf_free = p_menu_set->p_menu_screen_buf;          p_menu_set->p_menu_screen_buf_free = p_menu_set->p_menu_screen_buf;
121    
122          p_menu_set->menu_count = 0;          p_menu_set->menu_count = 0;
# Line 118  int load_menu(MENU_SET *p_menu_set, cons Line 124  int load_menu(MENU_SET *p_menu_set, cons
124          p_menu_set->menu_screen_count = 0;          p_menu_set->menu_screen_count = 0;
125          p_menu_set->choose_step = 0;          p_menu_set->choose_step = 0;
126          p_menu_set->menu_id_path[0] = 0;          p_menu_set->menu_id_path[0] = 0;
127            p_menu_set->menu_item_pos[0] = 0;
128            p_menu_set->allow_exit = 0;
129    
130          while (fgets(buffer, sizeof(buffer), fin))          while (fgets(buffer, sizeof(buffer), fin))
131          {          {
# Line 159  int load_menu(MENU_SET *p_menu_set, cons Line 167  int load_menu(MENU_SET *p_menu_set, cons
167                                  p_menu->item_count = 0;                                  p_menu->item_count = 0;
168                                  p_menu->title.show = 0;                                  p_menu->title.show = 0;
169                                  p_menu->screen_show = 0;                                  p_menu->screen_show = 0;
170                                    p_menu->page_item_limit = 0;
171                                    p_menu->use_filter = 0;
172                                    p_menu->filter_handler = NULL;
173    
174                                  q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);                                  q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
175                                  if (q == NULL)                                  if (q == NULL)
# Line 167  int load_menu(MENU_SET *p_menu_set, cons Line 178  int load_menu(MENU_SET *p_menu_set, cons
178                                          return -1;                                          return -1;
179                                  }                                  }
180                                  p = q;                                  p = q;
181                                  while (isalnum(*q) || *q == '_')                                  while (isalnum(*q) || *q == '_' || *q == '-')
182                                  {                                  {
183                                          q++;                                          q++;
184                                  }                                  }
# Line 250  int load_menu(MENU_SET *p_menu_set, cons Line 261  int load_menu(MENU_SET *p_menu_set, cons
261                                                  else                                                  else
262                                                  {                                                  {
263                                                          q = p;                                                          q = p;
264                                                          while (isalnum(*q) || *q == '_')                                                          while (isalnum(*q) || *q == '_' || *q == '-')
265                                                          {                                                          {
266                                                                  q++;                                                                  q++;
267                                                          }                                                          }
# Line 356  int load_menu(MENU_SET *p_menu_set, cons Line 367  int load_menu(MENU_SET *p_menu_set, cons
367                                                  p = q;                                                  p = q;
368                                                  while (*q != '\0' && *q != '\"')                                                  while (*q != '\0' && *q != '\"')
369                                                  {                                                  {
370                                                            if (*q == '\\')
371                                                            {
372                                                                    r = q;
373                                                                    while (*r != '\0')
374                                                                    {
375                                                                            *r = *(r + 1);
376                                                                            r++;
377                                                                    }
378                                                            }
379                                                          q++;                                                          q++;
380                                                  }                                                  }
381                                                  if (*q != '\"' || *(q + 1) != '\0')                                                  if (*q != '\"' || *(q + 1) != '\0')
# Line 384  int load_menu(MENU_SET *p_menu_set, cons Line 404  int load_menu(MENU_SET *p_menu_set, cons
404                                                  p = q;                                                  p = q;
405                                                  while (*q != '\0' && *q != '\"')                                                  while (*q != '\0' && *q != '\"')
406                                                  {                                                  {
407                                                            if (*q == '\\')
408                                                            {
409                                                                    r = q;
410                                                                    while (*r != '\0')
411                                                                    {
412                                                                            *r = *(r + 1);
413                                                                            r++;
414                                                                    }
415                                                            }
416                                                          q++;                                                          q++;
417                                                  }                                                  }
418                                                  if (*q != '\"')                                                  if (*q != '\"')
# Line 462  int load_menu(MENU_SET *p_menu_set, cons Line 491  int load_menu(MENU_SET *p_menu_set, cons
491                                                  p = q;                                                  p = q;
492                                                  while (*q != '\0' && *q != '\"')                                                  while (*q != '\0' && *q != '\"')
493                                                  {                                                  {
494                                                            if (*q == '\\')
495                                                            {
496                                                                    r = q;
497                                                                    while (*r != '\0')
498                                                                    {
499                                                                            *r = *(r + 1);
500                                                                            r++;
501                                                                    }
502                                                            }
503                                                          q++;                                                          q++;
504                                                  }                                                  }
505                                                  if (*q != '\"')                                                  if (*q != '\"')
# Line 471  int load_menu(MENU_SET *p_menu_set, cons Line 509  int load_menu(MENU_SET *p_menu_set, cons
509                                                  }                                                  }
510                                                  *q = '\0';                                                  *q = '\0';
511    
512                                                  if (q - p > sizeof(p_menu_item->text) - 1)                                                  if (q - p > sizeof(p_menu->title.text) - 1)
513                                                  {                                                  {
514                                                          log_error("Too longer menu title text in menu config line %d\n", fin_line);                                                          log_error("Too longer menu title text in menu config line %d\n", fin_line);
515                                                          return -1;                                                          return -1;
# Line 537  int load_menu(MENU_SET *p_menu_set, cons Line 575  int load_menu(MENU_SET *p_menu_set, cons
575                                                          return -1;                                                          return -1;
576                                                  }                                                  }
577                                                  p = q;                                                  p = q;
578                                                  while (isalnum(*q) || *q == '_')                                                  while (isalnum(*q) || *q == '_' || *q == '-')
579                                                  {                                                  {
580                                                          q++;                                                          q++;
581                                                  }                                                  }
# Line 546  int load_menu(MENU_SET *p_menu_set, cons Line 584  int load_menu(MENU_SET *p_menu_set, cons
584                                                          log_error("Error menu screen name in menu config line %d\n", fin_line);                                                          log_error("Error menu screen name in menu config line %d\n", fin_line);
585                                                          return -1;                                                          return -1;
586                                                  }                                                  }
587                                                  if (trie_dict_get(p_menu_set->p_menu_screen_dict, p, (int64_t *)&screen_id) != 1)                                                  strncpy(p_menu->screen_name, p, sizeof(p_menu->screen_name) - 1);
588                                                    p_menu->screen_name[sizeof(p_menu->screen_name) - 1] = '\0';
589    
590                                                    // Check syntax
591                                                    q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
592                                                    if (q != NULL)
593                                                    {
594                                                            log_error("Unknown extra content in menu config line %d\n", fin_line);
595                                                            return -1;
596                                                    }
597                                            }
598                                            else if (strcmp(p, "page") == 0)
599                                            {
600                                                    // Menu page row
601                                                    q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
602                                                    if (q == NULL)
603                                                    {
604                                                            log_error("Error menu page row in menu config line %d\n", fin_line);
605                                                            return -1;
606                                                    }
607                                                    p = q;
608                                                    while (isdigit(*q))
609                                                    {
610                                                            q++;
611                                                    }
612                                                    if (*q != '\0')
613                                                    {
614                                                            log_error("Error menu page row in menu config line %d\n", fin_line);
615                                                            return -1;
616                                                    }
617                                                    p_menu->page_row = (int16_t)atoi(p);
618    
619                                                    // Menu page col
620                                                    q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
621                                                    if (q == NULL)
622                                                    {
623                                                            log_error("Error menu page col in menu config line %d\n", fin_line);
624                                                            return -1;
625                                                    }
626                                                    p = q;
627                                                    while (isdigit(*q))
628                                                    {
629                                                            q++;
630                                                    }
631                                                    if (*q != '\0')
632                                                    {
633                                                            log_error("Error menu page col in menu config line %d\n", fin_line);
634                                                            return -1;
635                                                    }
636                                                    p_menu->page_col = (int16_t)atoi(p);
637    
638                                                    // Menu page item limit
639                                                    q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
640                                                    if (q == NULL)
641                                                    {
642                                                            log_error("Error menu page item limit in menu config line %d\n", fin_line);
643                                                            return -1;
644                                                    }
645                                                    p = q;
646                                                    while (isdigit(*q))
647                                                    {
648                                                            q++;
649                                                    }
650                                                    if (*q != '\0')
651                                                    {
652                                                            log_error("Error menu page item limit in menu config line %d\n", fin_line);
653                                                            return -1;
654                                                    }
655                                                    p_menu->page_item_limit = (int16_t)atoi(p);
656    
657                                                    // Check syntax
658                                                    q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
659                                                    if (q != NULL)
660                                                  {                                                  {
661                                                          log_error("Undefined menu screen [%s]\n", p);                                                          log_error("Unknown extra content in menu config line %d\n", fin_line);
662                                                          return -1;                                                          return -1;
663                                                  }                                                  }
664                                                  p_menu->screen_id = screen_id;                                          }
665                                            else if (strcmp(p, "use_filter") == 0)
666                                            {
667                                                    p_menu->use_filter = 1;
668    
669                                                  // Check syntax                                                  // Check syntax
670                                                  q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);                                                  q = strtok_r(NULL, MENU_CONF_DELIM_WITH_SPACE, &saveptr);
# Line 576  int load_menu(MENU_SET *p_menu_set, cons Line 689  int load_menu(MENU_SET *p_menu_set, cons
689                                  p_screen = get_menu_screen_by_id(p_menu_set, screen_id);                                  p_screen = get_menu_screen_by_id(p_menu_set, screen_id);
690    
691                                  q = p;                                  q = p;
692                                  while (isalnum(*q) || *q == '_')                                  while (isalnum(*q) || *q == '_' || *q == '-')
693                                  {                                  {
694                                          q++;                                          q++;
695                                  }                                  }
# Line 628  int load_menu(MENU_SET *p_menu_set, cons Line 741  int load_menu(MENU_SET *p_menu_set, cons
741                                                  break;                                                  break;
742                                          }                                          }
743    
744                                            // Clear line
745                                            if (p_menu_set->p_menu_screen_buf_free + strlen(CTRL_SEQ_CLR_LINE) > q)
746                                            {
747                                                    log_error("Menu screen buffer depleted (%p + %d > %p)\n", p_menu_set->p_menu_screen_buf_free, q, strlen(CTRL_SEQ_CLR_LINE));
748                                                    return -3;
749                                            }
750                                            p_menu_set->p_menu_screen_buf_free = stpcpy(p_menu_set->p_menu_screen_buf_free, CTRL_SEQ_CLR_LINE);
751    
752                                          p = buffer;                                          p = buffer;
753                                          while (*p != '\0')                                          while (*p != '\0')
754                                          {                                          {
# Line 663  int load_menu(MENU_SET *p_menu_set, cons Line 784  int load_menu(MENU_SET *p_menu_set, cons
784          }          }
785          fclose(fin);          fclose(fin);
786    
787          // Set menu_item->action_menu_id of each menu item pointing to a submenu to the menu_id of the corresponding submenu          for (menu_id = 0; menu_id < p_menu_set->menu_count; menu_id++)
788            {
789                    p_menu = get_menu_by_id(p_menu_set, menu_id);
790    
791                    if (trie_dict_get(p_menu_set->p_menu_screen_dict, p_menu->screen_name, (int64_t *)(&(p_menu->screen_id))) != 1)
792                    {
793                            log_error("Undefined menu screen [%s]\n", p);
794                            return -1;
795                    }
796    
797                    // Set menu->filter_handler of each menu pointing to filter
798                    if (p_menu->use_filter == 1)
799                    {
800                            if ((p_menu->filter_handler = get_cmd_handler(p_menu->name)) == NULL)
801                            {
802                                    log_error("Undefined menu filter handler [%s]\n", p_menu->name);
803                                    return -1;
804                            }
805                    }
806            }
807    
808          for (menu_item_id = 0; menu_item_id < p_menu_set->menu_item_count; menu_item_id++)          for (menu_item_id = 0; menu_item_id < p_menu_set->menu_item_count; menu_item_id++)
809          {          {
810                  p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);                  p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
811                  if (p_menu_item->submenu == 1 && strcmp(p_menu_item->action, "..") != 0)  
812                    // Set menu_item->action_cmd_handler of each menu item pointing to bbs_cmd
813                    if (p_menu_item->submenu == 0)
814                    {
815                            if ((p_menu_item->action_cmd_handler = get_cmd_handler(p_menu_item->action)) == NULL)
816                            {
817                                    log_error("Undefined menu action cmd handler [%s]\n", p_menu_item->action);
818                                    return -1;
819                            }
820                    }
821                    // Set menu_item->action_menu_id of each menu item pointing to a submenu to the menu_id of the corresponding submenu
822                    else if (strcmp(p_menu_item->action, "..") != 0)
823                  {                  {
824                          if (trie_dict_get(p_menu_set->p_menu_name_dict, p_menu_item->action, (int64_t *)&menu_id) != 1)                          if (trie_dict_get(p_menu_set->p_menu_name_dict, p_menu_item->action, (int64_t *)&menu_id) != 1)
825                          {                          {
826                                  log_error("Undefined menu action [%s]\n", p_menu_item->action);                                  log_error("Undefined sub menu id [%s]\n", p_menu_item->action);
827                                  return -1;                                  return -1;
828                          }                          }
829                          p_menu_item->action_menu_id = menu_id;                          p_menu_item->action_menu_id = menu_id;
# Line 686  int load_menu(MENU_SET *p_menu_set, cons Line 838  int load_menu(MENU_SET *p_menu_set, cons
838          return 0;          return 0;
839  }  }
840    
841  static int display_menu_cursor(MENU_SET *p_menu_set, int show)  int display_menu_cursor(MENU_SET *p_menu_set, int show)
842  {  {
843          MENU_ID menu_id;          MENU_ID menu_id;
844          MENU_ITEM_ID menu_item_id;          MENU_ITEM_ID menu_item_id;
# Line 713  static int display_menu_cursor(MENU_SET Line 865  static int display_menu_cursor(MENU_SET
865    
866          moveto(p_menu_set->menu_item_r_row[menu_item_pos], p_menu_set->menu_item_r_col[menu_item_pos] - 2);          moveto(p_menu_set->menu_item_r_row[menu_item_pos], p_menu_set->menu_item_r_col[menu_item_pos] - 2);
867          outc(show ? '>' : ' ');          outc(show ? '>' : ' ');
         iflush();  
868    
869          return 0;          return 0;
870  }  }
871    
872  int display_menu(MENU_SET *p_menu_set)  static int display_menu_current_page(MENU_SET *p_menu_set)
873  {  {
874          int16_t row = 0;          int16_t row = 0;
875          int16_t col = 0;          int16_t col = 0;
         int menu_selectable = 0;  
876          MENU_ID menu_id;          MENU_ID menu_id;
877          MENU_ITEM_ID menu_item_id;          MENU_ITEM_ID menu_item_id;
878          MENU *p_menu;          MENU *p_menu;
879          MENU_ITEM *p_menu_item;          MENU_ITEM *p_menu_item;
         MENU_SCREEN *p_menu_screen;  
880          int16_t menu_item_pos;          int16_t menu_item_pos;
881            int16_t page_id = 0;
882            MENU_SCREEN *p_menu_screen;
883    
884          menu_id = p_menu_set->menu_id_path[p_menu_set->choose_step];          menu_id = p_menu_set->menu_id_path[p_menu_set->choose_step];
885          p_menu = get_menu_by_id(p_menu_set, menu_id);          p_menu = get_menu_by_id(p_menu_set, menu_id);
# Line 738  int display_menu(MENU_SET *p_menu_set) Line 889  int display_menu(MENU_SET *p_menu_set)
889                  return -1;                  return -1;
890          }          }
891    
892          menu_item_pos = p_menu_set->menu_item_pos[p_menu_set->choose_step];          clrline(p_menu->page_row, p_menu->page_row + p_menu->page_item_limit - 1);
         menu_item_id = p_menu->items[menu_item_pos];  
         p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);  
         if (p_menu_item == NULL)  
         {  
                 log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);  
                 return -1;  
         }  
   
         if (menu_item_pos > 0 &&  
                 checkpriv(&BBS_priv, 0, p_menu_item->priv) != 0 &&  
                 checklevel(&BBS_priv, p_menu_item->level) != 0)  
         {  
                 menu_selectable = 1;  
         }  
893    
894          if (p_menu->title.show)          if (p_menu->title.show)
895          {          {
896                  show_top(p_menu->title.text);                  if (p_menu->title.row == 0 && p_menu->title.col == 0)
897                    {
898                            show_top(p_menu->title.text, BBS_name, "");
899                    }
900                    else
901                    {
902                            moveto(p_menu->title.row, p_menu->title.col);
903                            prints("%s", p_menu->title.text);
904                    }
905          }          }
906    
907          if (p_menu->screen_show)          if (p_menu->screen_show)
# Line 768  int display_menu(MENU_SET *p_menu_set) Line 913  int display_menu(MENU_SET *p_menu_set)
913                          return -1;                          return -1;
914                  }                  }
915    
916                  moveto(p_menu->screen_row, p_menu->screen_col);                  row = p_menu->screen_row;
917                    col = p_menu->screen_col;
918    
919                    moveto(row, col);
920                  prints("%s", p_menu_set->p_menu_screen_buf + p_menu_screen->buf_offset);                  prints("%s", p_menu_set->p_menu_screen_buf + p_menu_screen->buf_offset);
921                  iflush();          }
922    
923            menu_item_pos = p_menu_set->menu_item_pos[p_menu_set->choose_step];
924            page_id = p_menu_set->menu_item_page_id[menu_item_pos];
925    
926            while (menu_item_pos >= 0)
927            {
928                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
929                    {
930                            menu_item_pos++;
931                            break;
932                    }
933    
934                    if (menu_item_pos == 0)
935                    {
936                            break;
937                    }
938    
939                    menu_item_pos--;
940            }
941    
942            for (; menu_item_pos < p_menu->item_count; menu_item_pos++)
943            {
944                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
945                    {
946                            break;
947                    }
948    
949                    menu_item_id = p_menu->items[menu_item_pos];
950                    p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
951    
952                    if (p_menu_set->menu_item_display[menu_item_pos] == 0)
953                    {
954                            continue;
955                    }
956    
957                    row = p_menu_set->menu_item_r_row[menu_item_pos];
958                    col = p_menu_set->menu_item_r_col[menu_item_pos];
959    
960                    moveto(row, col);
961                    prints("%s", p_menu_item->text);
962            }
963    
964            return 0;
965    }
966    
967    int display_menu(MENU_SET *p_menu_set)
968    {
969            int16_t row = 0;
970            int16_t col = 0;
971            int menu_selectable = 0;
972            MENU_ID menu_id;
973            MENU_ITEM_ID menu_item_id;
974            MENU *p_menu;
975            MENU_ITEM *p_menu_item;
976            int16_t menu_item_pos;
977            int16_t page_id = 0;
978            int page_item_count = 0;
979    
980            menu_id = p_menu_set->menu_id_path[p_menu_set->choose_step];
981            p_menu = get_menu_by_id(p_menu_set, menu_id);
982            if (p_menu == NULL)
983            {
984                    log_error("get_menu_by_id(%d) return NULL pointer\n", menu_id);
985                    if (p_menu_set->choose_step > 0)
986                    {
987                            p_menu_set->choose_step--;
988                            return REDRAW;
989                    }
990                    return EXITMENU;
991            }
992    
993            if (p_menu->item_count <= 0) // empty menu
994            {
995                    moveto(p_menu->screen_row, p_menu->screen_col);
996                    clrtoeol();
997                    prints("没有可选项");
998                    press_any_key();
999                    return -1;
1000            }
1001    
1002            menu_item_pos = p_menu_set->menu_item_pos[p_menu_set->choose_step];
1003            menu_item_id = p_menu->items[menu_item_pos];
1004            p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
1005            if (p_menu_item == NULL)
1006            {
1007                    log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);
1008                    return EXITMENU;
1009            }
1010    
1011            if (menu_item_pos > 0 &&
1012                    !(p_menu->use_filter ? (p_menu->filter_handler((void *)p_menu_item) == 0)
1013                                                             : (checkpriv(&BBS_priv, 0, p_menu_item->priv) == 0 ||
1014                                                                    checklevel2(&BBS_priv, p_menu_item->level) == 0)))
1015            {
1016                    menu_selectable = 1;
1017          }          }
1018    
1019          for (menu_item_pos = 0; menu_item_pos < p_menu->item_count; menu_item_pos++)          for (menu_item_pos = 0; menu_item_pos < p_menu->item_count; menu_item_pos++)
# Line 787  int display_menu(MENU_SET *p_menu_set) Line 1030  int display_menu(MENU_SET *p_menu_set)
1030                          col = p_menu_item->col;                          col = p_menu_item->col;
1031                  }                  }
1032    
1033                  if (checkpriv(&BBS_priv, 0, p_menu_item->priv) == 0 || checklevel(&BBS_priv, p_menu_item->level) == 0)                  p_menu_set->menu_item_page_id[menu_item_pos] = page_id;
1034    
1035                    if (p_menu->use_filter ? (p_menu->filter_handler((void *)p_menu_item) == 0)
1036                                                               : (checkpriv(&BBS_priv, 0, p_menu_item->priv) == 0 ||
1037                                                                      checklevel2(&BBS_priv, p_menu_item->level) == 0))
1038                  {                  {
1039                          p_menu_set->menu_item_display[menu_item_pos] = 0;                          p_menu_set->menu_item_display[menu_item_pos] = 0;
1040                          p_menu_set->menu_item_r_row[menu_item_pos] = 0;                          p_menu_set->menu_item_r_row[menu_item_pos] = 0;
# Line 806  int display_menu(MENU_SET *p_menu_set) Line 1053  int display_menu(MENU_SET *p_menu_set)
1053                          p_menu_set->menu_item_r_row[menu_item_pos] = row;                          p_menu_set->menu_item_r_row[menu_item_pos] = row;
1054                          p_menu_set->menu_item_r_col[menu_item_pos] = col;                          p_menu_set->menu_item_r_col[menu_item_pos] = col;
1055    
                         moveto(row, col);  
                         prints("%s", p_menu_item->text);  
   
1056                          row++;                          row++;
1057    
1058                            page_item_count++;
1059                            if (p_menu->page_item_limit > 0 && page_item_count >= p_menu->page_item_limit)
1060                            {
1061                                    page_id++;
1062                                    page_item_count = 0;
1063                                    row = p_menu->page_row;
1064                                    col = p_menu->page_col;
1065                            }
1066                  }                  }
1067          }          }
1068    
1069          if (!menu_selectable)          if (!menu_selectable)
1070          {          {
1071                    moveto(p_menu->screen_row, p_menu->screen_col);
1072                    clrtoeol();
1073                    prints("没有可选项");
1074                    press_any_key();
1075                    return -1;
1076            }
1077    
1078            if (display_menu_current_page(p_menu_set) != 0)
1079            {
1080                  return -1;                  return -1;
1081          }          }
1082    
# Line 830  int menu_control(MENU_SET *p_menu_set, i Line 1092  int menu_control(MENU_SET *p_menu_set, i
1092          MENU *p_menu;          MENU *p_menu;
1093          MENU_ITEM *p_menu_item;          MENU_ITEM *p_menu_item;
1094          int16_t menu_item_pos;          int16_t menu_item_pos;
1095            int16_t page_id;
1096            int require_page_change = 0;
1097    
1098          if (p_menu_set->menu_count == 0)          if (p_menu_set->menu_count == 0)
1099          {          {
1100                  return 0;                  log_error("Empty menu set\n");
1101                    return EXITBBS;
1102          }          }
1103    
1104          menu_id = p_menu_set->menu_id_path[p_menu_set->choose_step];          menu_id = p_menu_set->menu_id_path[p_menu_set->choose_step];
# Line 841  int menu_control(MENU_SET *p_menu_set, i Line 1106  int menu_control(MENU_SET *p_menu_set, i
1106          if (p_menu == NULL)          if (p_menu == NULL)
1107          {          {
1108                  log_error("get_menu_by_id(%d) return NULL pointer\n", menu_id);                  log_error("get_menu_by_id(%d) return NULL pointer\n", menu_id);
1109                  return -1;                  if (p_menu_set->choose_step > 0)
1110                    {
1111                            p_menu_set->choose_step--;
1112                            return REDRAW;
1113                    }
1114                    return EXITBBS;
1115          }          }
1116    
1117          if (p_menu->item_count == 0)          if (p_menu->item_count == 0)
1118          {          {
1119                  return 0;  #ifdef _DEBUG
1120                    log_error("Empty menu (%s)\n", p_menu->name);
1121    #endif
1122                    if (p_menu_set->choose_step > 0)
1123                    {
1124                            p_menu_set->choose_step--;
1125                            return REDRAW;
1126                    }
1127                    return EXITBBS;
1128          }          }
1129    
1130          menu_item_pos = p_menu_set->menu_item_pos[p_menu_set->choose_step];          menu_item_pos = p_menu_set->menu_item_pos[p_menu_set->choose_step];
1131            page_id = p_menu_set->menu_item_page_id[menu_item_pos];
1132    
1133          menu_item_id = p_menu->items[menu_item_pos];          menu_item_id = p_menu->items[menu_item_pos];
1134          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
1135          if (p_menu_item == NULL)          if (p_menu_item == NULL)
1136          {          {
1137                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);
1138                  return -1;                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = 0;
1139                    return REDRAW;
1140          }          }
1141    
1142          switch (key)          switch (key)
1143          {          {
1144          case CR:          case CR:
                 igetch_reset();  
1145          case KEY_RIGHT:          case KEY_RIGHT:
1146                  if (p_menu_item->submenu)                  if (p_menu_item->submenu)
1147                  {                  {
# Line 880  int menu_control(MENU_SET *p_menu_set, i Line 1160  int menu_control(MENU_SET *p_menu_set, i
1160                  }                  }
1161                  else                  else
1162                  {                  {
1163                          return (exec_cmd(p_menu_item->action, p_menu_item->name));                          return ((*(p_menu_item->action_cmd_handler))((void *)(p_menu_item->name)));
1164                  }                  }
1165                  break;                  break;
1166            case KEY_ESC:
1167          case KEY_LEFT:          case KEY_LEFT:
1168                  if (p_menu_set->choose_step > 0)                  if (p_menu_set->choose_step > 0)
1169                  {                  {
1170                          p_menu_set->choose_step--;                          p_menu_set->choose_step--;
1171                          if (display_menu(p_menu_set) != 0)                          return REDRAW;
                         {  
                                 return menu_control(p_menu_set, KEY_LEFT);  
                         }  
1172                  }                  }
1173                  else                  else
1174                  {                  {
1175                            if (p_menu_set->allow_exit)
1176                            {
1177                                    return EXITMENU;
1178                            }
1179    
1180                          display_menu_cursor(p_menu_set, 0);                          display_menu_cursor(p_menu_set, 0);
1181                          menu_item_pos = p_menu->item_count - 1;                          menu_item_pos = p_menu->item_count - 1;
1182                          while (menu_item_pos >= 0)                          while (menu_item_pos >= 0)
# Line 919  int menu_control(MENU_SET *p_menu_set, i Line 1202  int menu_control(MENU_SET *p_menu_set, i
1202                          display_menu_cursor(p_menu_set, 1);                          display_menu_cursor(p_menu_set, 1);
1203                  }                  }
1204                  break;                  break;
1205            case KEY_PGUP:
1206                    require_page_change = 1;
1207          case KEY_UP:          case KEY_UP:
1208                  display_menu_cursor(p_menu_set, 0);                  display_menu_cursor(p_menu_set, 0);
1209                  do                  do
# Line 927  int menu_control(MENU_SET *p_menu_set, i Line 1212  int menu_control(MENU_SET *p_menu_set, i
1212                          if (menu_item_pos < 0)                          if (menu_item_pos < 0)
1213                          {                          {
1214                                  menu_item_pos = p_menu->item_count - 1;                                  menu_item_pos = p_menu->item_count - 1;
1215                                    require_page_change = 0;
1216                          }                          }
1217                          menu_item_id = p_menu->items[menu_item_pos];                          menu_item_id = p_menu->items[menu_item_pos];
1218                          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);                          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
# Line 935  int menu_control(MENU_SET *p_menu_set, i Line 1221  int menu_control(MENU_SET *p_menu_set, i
1221                                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);                                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);
1222                                  return -1;                                  return -1;
1223                          }                          }
1224                  } while (!p_menu_set->menu_item_display[menu_item_pos]);                          if (require_page_change && p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1225                            {
1226                                    require_page_change = 0;
1227                            }
1228                    } while (require_page_change || !p_menu_set->menu_item_display[menu_item_pos]);
1229                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;
1230                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1231                    {
1232                            display_menu_current_page(p_menu_set);
1233                    }
1234                  display_menu_cursor(p_menu_set, 1);                  display_menu_cursor(p_menu_set, 1);
1235                  break;                  break;
1236            case KEY_PGDN:
1237                    require_page_change = 1;
1238          case KEY_DOWN:          case KEY_DOWN:
1239                  display_menu_cursor(p_menu_set, 0);                  display_menu_cursor(p_menu_set, 0);
1240                  do                  do
# Line 947  int menu_control(MENU_SET *p_menu_set, i Line 1243  int menu_control(MENU_SET *p_menu_set, i
1243                          if (menu_item_pos >= p_menu->item_count)                          if (menu_item_pos >= p_menu->item_count)
1244                          {                          {
1245                                  menu_item_pos = 0;                                  menu_item_pos = 0;
1246                                    require_page_change = 0;
1247                          }                          }
1248                          menu_item_id = p_menu->items[menu_item_pos];                          menu_item_id = p_menu->items[menu_item_pos];
1249                          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);                          p_menu_item = get_menu_item_by_id(p_menu_set, menu_item_id);
# Line 955  int menu_control(MENU_SET *p_menu_set, i Line 1252  int menu_control(MENU_SET *p_menu_set, i
1252                                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);                                  log_error("get_menu_item_by_id(%d) return NULL pointer\n", menu_item_id);
1253                                  return -1;                                  return -1;
1254                          }                          }
1255                  } while (!p_menu_set->menu_item_display[menu_item_pos]);                          if (require_page_change && p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1256                            {
1257                                    require_page_change = 0;
1258                            }
1259                    } while (require_page_change || !p_menu_set->menu_item_display[menu_item_pos]);
1260                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;
1261                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1262                    {
1263                            display_menu_current_page(p_menu_set);
1264                    }
1265                  display_menu_cursor(p_menu_set, 1);                  display_menu_cursor(p_menu_set, 1);
1266                  break;                  break;
1267          case KEY_PGUP:          case KEY_HOME:
1268                  display_menu_cursor(p_menu_set, 0);                  display_menu_cursor(p_menu_set, 0);
1269                  menu_item_pos = 0;                  menu_item_pos = 0;
1270                  while (menu_item_pos < p_menu->item_count - 1)                  while (menu_item_pos < p_menu->item_count - 1)
# Line 980  int menu_control(MENU_SET *p_menu_set, i Line 1285  int menu_control(MENU_SET *p_menu_set, i
1285                          menu_item_pos++;                          menu_item_pos++;
1286                  }                  }
1287                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;
1288                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1289                    {
1290                            display_menu_current_page(p_menu_set);
1291                    }
1292                  display_menu_cursor(p_menu_set, 1);                  display_menu_cursor(p_menu_set, 1);
1293                  break;                  break;
1294          case KEY_PGDN:          case KEY_END:
1295                  display_menu_cursor(p_menu_set, 0);                  display_menu_cursor(p_menu_set, 0);
1296                  menu_item_pos = p_menu->item_count - 1;                  menu_item_pos = p_menu->item_count - 1;
1297                  while (menu_item_pos > 0)                  while (menu_item_pos > 0)
# Line 1003  int menu_control(MENU_SET *p_menu_set, i Line 1312  int menu_control(MENU_SET *p_menu_set, i
1312                          menu_item_pos--;                          menu_item_pos--;
1313                  }                  }
1314                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;                  p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;
1315                    if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1316                    {
1317                            display_menu_current_page(p_menu_set);
1318                    }
1319                  display_menu_cursor(p_menu_set, 1);                  display_menu_cursor(p_menu_set, 1);
1320                  break;                  break;
1321          default:          default:
# Line 1022  int menu_control(MENU_SET *p_menu_set, i Line 1335  int menu_control(MENU_SET *p_menu_set, i
1335                                  {                                  {
1336                                          display_menu_cursor(p_menu_set, 0);                                          display_menu_cursor(p_menu_set, 0);
1337                                          p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;                                          p_menu_set->menu_item_pos[p_menu_set->choose_step] = menu_item_pos;
1338                                            if (p_menu_set->menu_item_page_id[menu_item_pos] != page_id)
1339                                            {
1340                                                    display_menu_current_page(p_menu_set);
1341                                            }
1342                                          display_menu_cursor(p_menu_set, 1);                                          display_menu_cursor(p_menu_set, 1);
1343                                          return 0;                                          break;
1344                                  }                                  }
1345                          }                          }
1346                  }                  }
1347                  break;                  break;
1348          }          }
1349    
1350          return 0;          return NOREDRAW;
1351  }  }
1352    
1353  int unload_menu(MENU_SET *p_menu_set)  int unload_menu(MENU_SET *p_menu_set)
1354  {  {
1355            int shmid;
1356    
1357            if (p_menu_set == NULL)
1358            {
1359                    return -1;
1360            }
1361    
1362          if (p_menu_set->p_menu_name_dict != NULL)          if (p_menu_set->p_menu_name_dict != NULL)
1363          {          {
1364                  trie_dict_destroy(p_menu_set->p_menu_name_dict);                  trie_dict_destroy(p_menu_set->p_menu_name_dict);
# Line 1047  int unload_menu(MENU_SET *p_menu_set) Line 1371  int unload_menu(MENU_SET *p_menu_set)
1371                  p_menu_set->p_menu_screen_dict = NULL;                  p_menu_set->p_menu_screen_dict = NULL;
1372          }          }
1373    
1374          unload_menu_shm(p_menu_set);          shmid = p_menu_set->shmid;
1375    
1376          if (shmctl(p_menu_set->shmid, IPC_RMID, NULL) == -1)          detach_menu_shm(p_menu_set);
1377    
1378            if (shmctl(shmid, IPC_RMID, NULL) == -1)
1379          {          {
1380                  log_error("shmctl(shmid=%d, IPC_RMID) error (%d)\n", p_menu_set->shmid, errno);                  log_error("shmctl(shmid=%d, IPC_RMID) error (%d)\n", shmid, errno);
1381                  return -1;                  return -1;
1382          }          }
1383    
1384          return 0;          return 0;
1385  }  }
1386    
1387  int load_menu_shm(MENU_SET *p_menu_set)  int get_menu_shm_readonly(MENU_SET *p_menu_set)
1388  {  {
1389          // Mount shared memory          void *p_shm;
1390          if (p_menu_set->p_reserved != NULL)  
1391            p_shm = shmat(p_menu_set->shmid, NULL, SHM_RDONLY);
1392            if (p_shm == (void *)-1)
1393          {          {
1394                  log_error("Menu is already loaded\n");                  log_error("shmat(menu_shm shmid = %d) error (%d)\n", p_menu_set->shmid, errno);
1395                  return -1;                  return -1;
1396          }          }
1397    
1398          p_menu_set->p_reserved = shmat(p_menu_set->shmid, NULL, SHM_RDONLY);          p_menu_set->p_reserved = p_shm;
1399          if (p_menu_set->p_reserved == (void *)-1)          p_menu_set->p_menu_pool = (char *)(p_menu_set->p_reserved) + MENU_SET_RESERVED_LENGTH;
1400          {          p_menu_set->p_menu_item_pool = (char *)(p_menu_set->p_menu_pool) + sizeof(MENU) * MAX_MENUS;
1401                  log_error("shmat() error (%d)\n", errno);          p_menu_set->p_menu_screen_pool = (char *)(p_menu_set->p_menu_item_pool) + sizeof(MENU_ITEM) * MAX_MENUITEMS;
1402                  return -2;          p_menu_set->p_menu_screen_buf = (char *)(p_menu_set->p_menu_screen_pool) + sizeof(MENU_SCREEN) * MAX_MENUS;
         }  
         p_menu_set->p_menu_pool = p_menu_set->p_reserved + MENU_SET_RESERVED_LENGTH;  
         p_menu_set->p_menu_item_pool = p_menu_set->p_menu_pool + sizeof(MENU) * MAX_MENUS;  
         p_menu_set->p_menu_screen_pool = p_menu_set->p_menu_item_pool + sizeof(MENU_ITEM) * MAX_MENUITEMS;  
         p_menu_set->p_menu_screen_buf = p_menu_set->p_menu_screen_pool + sizeof(MENU_SCREEN) * MAX_MENUS;  
1403          p_menu_set->p_menu_screen_buf_free = p_menu_set->p_menu_screen_buf;          p_menu_set->p_menu_screen_buf_free = p_menu_set->p_menu_screen_buf;
1404    
         // Restore status varaibles into reserved memory area  
         p_menu_set->menu_count = *((int16_t *)p_menu_set->p_reserved);  
         p_menu_set->menu_item_count = *(((int16_t *)p_menu_set->p_reserved) + 1);  
         p_menu_set->menu_screen_count = *(((int16_t *)p_menu_set->p_reserved) + 2);  
   
1405          p_menu_set->choose_step = 0;          p_menu_set->choose_step = 0;
1406          p_menu_set->menu_id_path[0] = 0;          p_menu_set->menu_id_path[0] = 0;
1407            p_menu_set->menu_item_pos[0] = 0;
1408    
1409          p_menu_set->p_menu_name_dict = NULL;          return 0;
1410          p_menu_set->p_menu_screen_dict = NULL;  }
1411    
1412    int set_menu_shm_readonly(MENU_SET *p_menu_set)
1413    {
1414            void *p_shm;
1415    
1416            // Remap shared memory in read-only mode
1417            p_shm = shmat(p_menu_set->shmid, p_menu_set->p_reserved, SHM_RDONLY | SHM_REMAP);
1418            if (p_shm == (void *)-1)
1419            {
1420                    log_error("shmat(menu_shm shmid = %d) error (%d)\n", p_menu_set->shmid, errno);
1421                    return -1;
1422            }
1423    
1424            p_menu_set->p_reserved = p_shm;
1425    
1426          return 0;          return 0;
1427  }  }
1428    
1429  int unload_menu_shm(MENU_SET *p_menu_set)  int detach_menu_shm(MENU_SET *p_menu_set)
1430  {  {
1431          p_menu_set->menu_count = 0;          p_menu_set->menu_count = 0;
1432          p_menu_set->menu_item_count = 0;          p_menu_set->menu_item_count = 0;
# Line 1106  int unload_menu_shm(MENU_SET *p_menu_set Line 1439  int unload_menu_shm(MENU_SET *p_menu_set
1439          p_menu_set->p_menu_screen_buf = NULL;          p_menu_set->p_menu_screen_buf = NULL;
1440          p_menu_set->p_menu_screen_buf_free = NULL;          p_menu_set->p_menu_screen_buf_free = NULL;
1441    
1442            p_menu_set->p_menu_name_dict = NULL;
1443            p_menu_set->p_menu_screen_dict = NULL;
1444    
1445          if (p_menu_set->p_reserved != NULL && shmdt(p_menu_set->p_reserved) == -1)          if (p_menu_set->p_reserved != NULL && shmdt(p_menu_set->p_reserved) == -1)
1446          {          {
1447                  log_error("shmdt() error (%d)\n", errno);                  log_error("shmdt() error (%d)\n", errno);
1448                  return -1;                  return -1;
1449          }          }
1450    
1451          p_menu_set->p_reserved = NULL;          p_menu_set->p_reserved = NULL;
1452    
1453          return 0;          return 0;


Legend:
Removed lines/characters  
Changed lines/characters
  Added lines/characters

webmaster@leafok.com
ViewVC Help
Powered by ViewVC 1.3.0-beta1