NAZWA

       ioctl_vt - funkcje ioctl konsoli i konsoli wirtualnych

SKŁADNIA

       #include <linux/vt.h>  /* Definicja stałych VT_* */
       #include <sys/ioctl.h>

       int ioctl(int fd, unsigned long op, void *argp);

OPIS

       Przedstawione poniżej operacje ioctl(2) są specyficzne dla Linuksa i są obsługiwane dla konsoli i konsoli
       wirtualnych.

       VT_OPENQRY
              Przekazanie  pierwszej  dostępnej  (ale  nie otwartej) konsoli. argp wskazuje na zmienną typu int,
              której zostanie nadana wartość równa numerowi konsoli wirtualnej (1 <= *argp <= MAX_NR_CONSOLES).

       VT_GETMODE
              Pobranie trybu aktywnej konsoli wirtualnej. argp wskazuje na strukturę

                  struct vt_mode {
                      char  mode;    /* tryb konsoli wirtualnej */
                      char  waitv;   /* jeśli ustawione, czeka przy zapisie
                                        jeśli konsola wirt. nie jest aktywna */
                      short relsig;  /* sygnał w przypadku zwolnienia op. */
                      short acqsig;  /* sygnał w przypadku uzyskania */
                      short frsig;   /* niewykorzystane (równe 0) */
                  };

              w  której  przekazywany  jest  tryb  pracy  bieżącej  konsoli  wirtualnej.  mode  może  przyjmować
              następujące wartości:
              VT_AUTO      automatyczne przełączanie vt
              VT_PROCESS   przełączanie kontrolowane przez procesy
              VT_ACKACQ    potwierdzanie przełączenia

       VT_SETMODE
              Ustawienie trybu aktywnej konsoli wirtualnej. argp wskazuje na strukturę struct vt_mode.

       VT_GETSTATE
              Pobranie globalnych informacji o stanie konsoli wirtualnej. argp wskazuje na strukturę

                  struct vt_stat {
                      unsigned short v_active;  /* aktywna konsola wirtualna */
                      unsigned short v_signal;  /* sygnał do wysłania */
                      unsigned short v_state;   /* maska bitowa konsoli wirt. */
                  };
                  struct vt_stat {
                      ushort v_active;  /* aktywna konsola wirtualna */
                      ushort v_signal;  /* sygnał do wysłania */
                      ushort v_state;   /* maska bitowa konsoli wirt. */
                  };

              Dla  każdej  aktualnie  używanej konsoli ustawiany jest odpowiedni bit w polu v_state. (Od Linuksa
              1.0 do Linuksa 1.1.92).

       VT_RELDISP
              Zwolnienie ekranu.

       VT_ACTIVATE
              Przełączenie na konsolę argp (1 <= argp <= MAX_NR_CONSOLES).

       VT_WAITACTIVE
              Oczekiwanie na aktywację konsoli wirtualnej argp.

       VT_DISALLOCATE
              Zwolnienie pamięci przydzielonej dla konsoli wirtualnej argp. (Od Linuksa 1.1.54).

       VT_RESIZE
              Zmiana wyobrażenia jądra o rozmiarach ekranu. argp wskazuje na strukturę

                  struct vt_sizes {
                      unsigned short v_rows;       /* liczba wierszy */
                      unsigned short v_cols;       /* liczba kolumn */
                      unsigned short v_scrollsize; /* już nieużywane */
                  };

              Należy pamiętać, że nie zmienia to  trybu  karty  graficznej.  Patrz  resizecons(8).  (Od  Linuksa
              1.1.54).

       VT_RESIZEX
              Zmiana wyobrażenia jądra o różnych parametrach ekranu. argp wskazuje na strukturę

                  struct vt_consize {
                      unsigned short v_rows;  /* liczba wierszy */
                      unsigned short v_cols;  /* liczba kolumn */
                      unsigned short v_vlin;  /* liczba wierszy pikseli
                                                 na ekranie */
                      unsigned short v_clin;  /* liczba wierszy pikseli
                                                 na znak */
                      unsigned short v_vcol;  /* liczba kolumn pikseli
                                                 na ekranie */
                      unsigned short v_ccol;  /* liczba kolumn pikseli
                                                 na znak */
                  };

              Każdy  z  parametrów  może mieć wartość zerową, co oznacza "nie zmieniać", lecz jeśli jednocześnie
              zmienianych jest kilka parametrów, muszą one być ze sobą zgodne. Należy pamiętać, że  nie  zmienia
              to trybu karty graficznej. Patrz resizecons(8). (Od Linuksa 1.3.3).

WARTOŚĆ ZWRACANA

       Funkcja  zwraca 0, jeżeli zakończy się pomyślnie (chyba że zaznaczono inaczej). Jeśli wystąpi błąd zwraca
       -1 i ustawia errno wskazując błąd.

BŁĘDY

       EINVAL argp jest niepoprawne.

STANDARDY

       Linux.

ZOBACZ TAKŻE

       ioctl(2), ioctl_console(2)

TŁUMACZENIE

       Tłumaczenie niniejszej strony podręcznika:  Piotr  Pogorzelski  <piotr.pogorzelski@ippt.gov.pl>,  Andrzej
       Krzysztofowicz <ankry@green.mf.pg.gda.pl> i Michał Kułach <michal.kulach@gmail.com>

       Niniejsze  tłumaczenie  jest  wolną  dokumentacją.  Bliższe informacje o warunkach licencji można uzyskać
       zapoznając  się  z  GNU General Public License w wersji 3  lub  nowszej.   Nie   przyjmuje   się   ŻADNEJ
       ODPOWIEDZIALNOŚCI.

       Błędy  w  tłumaczeniu  strony  podręcznika  prosimy  zgłaszać  na  adres  listy  dyskusyjnej manpages-pl-
       list@lists.sourceforge.net.

Linux man-pages 6.9.1                          13 czerwca 2024 r.                                    ioctl_vt(2)