mq_open(3)                 Library Functions Manual                 mq_open(3)

NUME
       mq_open - deschide o coada de mesaje

BIBLIOTECA
       Biblioteca de timp real (librt, -lrt)

SINOPSIS
       #include <fcntl.h>           /* Pentru constantele O_* */
       #include <sys/stat.h>        /* Pentru constantele de mod */
       #include <mqueue.h>

       mqd_t mq_open(const char *nume, int oflag);
       mqd_t mq_open(const char *nume, int oflag, mode_t mode,
                     struct mq_attr *attr);

DESCRIERE
       mq_open() creeaza o noua coada de mesaje POSIX sau deschide o coada
       existenta. Coada este identificata prin nume. Pentru detalii despre
       construc<?>ia lui nume, consulta<?>i mq_overview(7).

       Argumentul oflag specifica fanioanele care controleaza func<?>ionarea
       apelului; (defini<?>iile valorilor fanioanelor pot fi ob<?>inute prin
       includerea <fcntl.h>). In oflag trebuie specificat exact unul dintre
       urmatoarele:

       O_RDONLY
              Deschide coada numai pentru a primi mesaje.

       O_WRONLY
              Deschide coada numai pentru a trimite mesaje.

       O_RDWR Deschide coada pentru a trimite <?>i a primi mesaje.

       Zero sau mai multe dintre urmatoarele fanioane pot fi adaugate cu
       operatorul OR in oflag:

       O_CLOEXEC (incepand cu Linux 2.6.26)
              Activeaza fanionul close-on-exec pentru descriptorul cozii de
              mesaje.  Consulta<?>i open(2) pentru a afla de ce este util
              acest fanion.

       O_CREAT
              Creeaza coada de mesaje daca aceasta nu exista. Proprietarul (ID
              utilizator) cozii de mesaje este stabilit la ID-ul
              utilizatorului efectiv al procesului apelant. Grupul proprietar
              (ID de grup) este stabilit la ID-ul de grup efectiv al
              procesului apelant.

       O_EXCL Daca O_CREAT a fost specificat in oflag, iar o coada cu numele
              nume dat exista deja, atunci e<?>ueaza cu eroarea EEXIST.

       O_NONBLOCK
              Deschide coada in modul neblocant. In situa<?>iile in care
              mq_receive(3) <?>i mq_send(3) s-ar bloca in mod normal, aceste
              func<?>ii e<?>ueaza cu eroarea EAGAIN.

       Daca O_CREAT este specificat in oflag, atunci trebuie furnizate doua
       argumente suplimentare. Argumentul mode specifica permisiunile care
       urmeaza sa fie plasate pe noua coada, ca pentru open(2); (defini<?>iile
       simbolice pentru bi<?>ii de permisiuni pot fi ob<?>inute prin
       includerea <sys/stat.h>). Defini<?>iile permisiunilor sunt mascate
       fa<?>a de umask-ul procesului.

       Campurile din struct mq_attr indicata de attr specifica numarul maxim
       de mesaje <?>i dimensiunea maxima a mesajelor pe care coada le va
       permite. Aceasta structura este definita dupa cum urmeaza:

           struct mq_attr {
               long mq_flags;       /* Fanioane (ignorate pentru mq_open()) */
               long mq_maxmsg;      /* Nr. maxim de mesaje in coada */
               long mq_msgsize;     /* Dimensiunea maxima a mesajului (octe<?>i) */
               long mq_curmsgs;     /* Nr. de mesaje aflate in prezent in coada
                                       (ignorat pentru mq_open()) */
           };

       Numai campurile mq_maxmsg <?>i mq_msgsize sunt utilizate atunci cand se
       apeleaza mq_open(); valorile din celelalte campuri sunt ignorate.

       Daca attr este NULL, atunci coada este creata cu atribute implicite
       definite de implementare. Incepand cu Linux 3.5, pot fi utilizate doua
       fi<?>iere /proc pentru a controla aceste valori implicite; consulta<?>i
       mq_overview(7) pentru detalii.

VALOAREA RETURNATA
       In caz de succes, mq_open() returneaza un descriptor al cozii de mesaje
       pentru a fi utilizat de alte func<?>ii ale cozii de mesaje. In caz de
       eroare, mq_open() returneaza (mqd_t) -1, cu errno configurata pentru a
       indica eroarea.

ERORI-IE<?>IRE
       EACCES Coada exista, dar apelantul nu are permisiunea de a o deschide
              in modul specificat.

       EACCES nume con<?>ine mai mult de o bara oblica.

       EEXIST Atat O_CREAT cat <?>i O_EXCL au fost specificate in oflag, dar o
              coada cu acest nume exista deja.

       EINVAL nume nu respecta formatul din mq_overview(7).

       EINVAL O_CREAT a fost specificat in oflag, iar attr nu era NULL, dar
              attr->mq_maxmsg sau attr->mq_msqsize nu era valid. Ambele
              campuri trebuie sa fie mai mari decat zero. Intr-un proces
              neprivilegiat (care nu are capacitatea CAP_SYS_RESOURCE),
              attr->mq_maxmsg trebuie sa fie mai mic sau egal cu limita
              msg_max, iar attr->mq_msgsize trebuie sa fie mai mic sau egal cu
              limita msgsize_max. In plus, chiar <?>i intr-un proces
              privilegiat, attr->mq_maxmsg nu poate depa<?>i limita HARD_MAX;
              (consulta<?>i mq_overview(7) pentru detalii despre aceste
              limite).

       EMFILE A fost atinsa limita per-proces a numarului de descriptori de
              fi<?>iere <?>i de cozi de mesaje deschise (a se vedea descrierea
              RLIMIT_NOFILE in getrlimit(2)).

       ENAMETOOLONG
              nume era prea lung.

       ENFILE A fost atinsa limita la nivel de sistem privind numarul total de
              fi<?>iere <?>i cozi de mesaje deschise.

       ENOENT Fanionul O_CREAT nu a fost specificat in oflag <?>i nu exista
              nicio coada cu acest nume.

       ENOENT nume era doar ,,/" urmat de niciun alt caracter.

       ENOMEM Memorie insuficienta.

       ENOSPC Spa<?>iu insuficient pentru crearea unei noi cozi de mesaje.
              Acest lucru s-a intamplat probabil pentru ca s-a atins limita
              queues_max; a se vedea mq_overview(7).

ATRIBUTE
       Pentru o explica<?>ie a termenilor folosi<?>i in aceasta sec<?>iune, a
       se vedea attributes(7).

       +--------------------------------------+---------------------+---------+
       |Interfa<?>a                           | Atribut             | Valoare |
       +--------------------------------------+---------------------+---------+
       |mq_open()                             | Siguran<?>a firelor | MT-Safe |
       +--------------------------------------+---------------------+---------+
VERSIUNI
   Diferen<?>e intre biblioteca C <?>i nucleu
       Func<?>ia de biblioteca mq_open() este implementata peste un apel de
       sistem cu acela<?>i nume. Func<?>ia de biblioteca verifica daca nume
       incepe cu o bara oblica (/), generand eroarea EINVAL in caz contrar.
       Apelul de sistem al nucleului se a<?>teapta ca nume sa nu con<?>ina
       nicio bara oblica anterioara, astfel incat func<?>ia de biblioteca C
       transmite nume fara bara oblica anterioara (adica nume+1) catre apelul
       de sistem.

STANDARDE
       POSIX.1-2008.

ISTORIC
       POSIX.1-2001.

ERORI
       Inainte de Linux 2.6.14, umask-ul procesului nu era aplicat
       permisiunilor specificate in mode.

CONSULTA<?>I <?>I
       mq_close(3), mq_getattr(3), mq_notify(3), mq_receive(3), mq_send(3),
       mq_unlink(3), mq_overview(7)

TRADUCERE
       Traducerea in limba romana a acestui manual a fost facuta de Remus-
       Gabriel Chelu <remusgabriel.chelu@disroot.org>

       Aceasta traducere este documenta<?>ie gratuita; citi<?>i Licen<?>a
       publica generala GNU Versiunea 3
       <https://www.gnu.org/licenses/gpl-3.0.html> sau o versiune ulterioara
       cu privire la condi<?>ii privind drepturile de autor.  NU se asuma
       NICIO RESPONSABILITATE.

       Daca gasi<?>i erori in traducerea acestui manual, va rugam sa
       trimite<?>i un e-mail la <translation-team-ro@lists.sourceforge.net>.

Pagini de manual de Linux 6.12   23 iulie 2024                      mq_open(3)