LOGINCTL(1) loginctl LOGINCTL(1) NUME loginctl - controleaza gestionarul de autentificare systemd SINOPSIS loginctl [OPIUNI...] {COMANDA} [NUME...] DESCRIERE loginctl poate fi utilizat pentru introspectarea i controlul starii gestionarului de autentificare systemd(1) systemd-logind.service(8) COMENZI Urmatoarele comenzi sunt inelese: Comenzi sesiune list-sessions Listeaza sesiunile curente. Formatul de ieire JSON poate fi selectat folosind opiunea --json= sau -j. session-status [ID...] Afieaza informaii laconice despre starea de funcionare a uneia sau mai multor sesiuni, urmate de cele mai recente date inregistrate din jurnal. Preia unul sau mai muli identificatori de sesiune ca parametri. Daca nu se paseaza niciun identificator de sesiune, se afieaza starea sesiunii apelantului. Aceasta funcie este menita sa genereze rezultate care pot fi citite de oameni. Daca dorii sa obinei o ieire analizabila de calculator, utilizai in schimb show-session. Adaugata in versiunea 233. show-session [ID...] Afieaza proprietaile uneia sau mai multor sesiuni sau ale gestionarului insui. Daca nu este specificat niciun argument, vor fi afiate proprietaile gestionarului. Daca este specificat un ID al sesiunii, sunt afiate proprietaile sesiunii. In mod special, daca ID-ul dat este ,,self", este utilizata sesiunea careia ii aparine procesul loginctl. Daca este ,,auto", se utilizeaza sesiunea curenta ca i cu ,,self", daca exista, i se revine la sesiunea grafica a utilizatorului curent. In mod implicit, proprietaile goale sunt suprimate. Utilizai --all pentru a le afia i pe acestea. Pentru a selecta anumite proprietai de afiat, utilizai --property=. Aceasta comanda este destinata utilizarii ori de cate ori este necesara o ieire care poate fi analizata de calculator. Utilizai session-status daca dorii o ieire formatata care poate fi citita de catre persoane. Adaugata in versiunea 233. activate [ID] Activeaza o sesiune. Aceasta aduce o sesiune in prim-plan daca o alta sesiune se afla in prim-plan pe locul respectiv. Primete ca argument un identificator de sesiune. Daca nu este specificat niciun argument, sesiunea apelantului este pusa in prim-plan. Adaugata in versiunea 219. lock-session [ID...], unlock-session [ID...] Activeaza/dezactiveaza blocarea ecranului pe una sau mai multe sesiuni, daca sesiunea accepta acest lucru. Primete unul sau mai multe identificatori de sesiune ca argumente. Daca nu este specificat niciun argument, sesiunea apelantului este blocata/deblocata. Adaugata in versiunea 233. lock-sessions, unlock-sessions Activeaza/dezactiveaza blocarea ecranului pe toate sesiunile curente care o accepta. Adaugata in versiunea 188. terminate-session ID... Incheie o sesiune. Aceasta oprete toate procesele din sesiune i elibereaza alocarile tuturor resurselor ataate sesiunii. Daca argumentul este specificat ca ir gol, sesiunea care invoca comanda este terminata. Adaugata in versiunea 233. kill-session ID... Trimite un semnal catre unul sau mai multe procese ale sesiunii. Utilizai --kill-whom= pentru a selecta ce proces sa fie omorat. Utilizai --signal= pentru a selecta semnalul de trimis. Daca argumentul este specificat ca ir gol, semnalul este trimis catre sesiunea care invoca comanda. Adaugata in versiunea 233. Comenzi utilizator list-users Listeaza utilizatorii conectai in prezent. Formatul de ieire JSON poate fi selectat folosind opiunea --json= sau -j. user-status [UTILIZATOR...] Afieaza informaii laconice despre starea de executare a unuia sau mai multor utilizatori conectai, urmate de cele mai recente date din jurnal. Primete ca parametri unul sau mai multe nume de utilizator sau ID-uri numerice de utilizator. Daca nu sunt trecui parametri, starea este afiata pentru utilizatorul din sesiunea apelantului. Aceasta funcie este menita sa genereze rezultate care pot fi citite de catre persoane. Daca dorii sa obinei un rezultat analizabil de calculator, utilizai in schimb show-user. Adaugata in versiunea 233. show-user [UTILIZATOR...] Afieaza proprietaile unuia sau mai multor utilizatori sau ale gestionarului insui. Daca nu este specificat niciun argument, vor fi afiate proprietaile gestionarului. Daca este specificat un utilizator, sunt afiate proprietaile utilizatorului. In mod implicit, proprietaile goale sunt suprimate. Utilizai --all pentru a le afia i pe acelea. Pentru a selecta anumite proprietai de afiat, utilizai --property=. Aceasta comanda este destinata a fi utilizata ori de cate ori este necesara o ieire care poate fi analizata de calculator. Utilizai user-status daca dorii o ieire formatata care poate fi citita de catre persoane. Adaugata in versiunea 233. enable-linger [UTILIZATOR...], disable-linger [UTILIZATOR...] Activeaza/dezactiveaza persistena utilizatorului pentru unul sau mai muli utilizatori. Daca este activata pentru un anumit utilizator, un gestionar de utilizatori este creat pentru utilizator la pornire i este pastrat dupa inchiderea sesiunii. Acest lucru permite utilizatorilor care nu sunt conectai sa ruleze servicii de lunga durata. Primete unul sau mai multe nume de utilizatori sau UID-uri numerice ca argument. Daca nu este specificat niciun argument, activeaza/dezactiveaza persistena pentru utilizatorul din sesiunea apelantului. A se vedea de asemenea opiunea KillUserProcesses= din logind.conf(5) Adaugata in versiunea 233. terminate-user UTILIZATOR... Termina toate sesiunile unui utilizator. Aceasta omoara toate procesele din toate sesiunile utilizatorului i elibereaza toate resursele alocate de timp de execuie ataate utilizatorului. Daca argumentul este specificat ca ir gol, sesiunile utilizatorului care invoca comanda sunt terminate. Adaugata in versiunea 233. kill-user UTILIZATOR... Trimite un semnal catre toate procesele unui utilizator. Utilizai --signal= pentru a selecta semnalul de trimis. Daca argumentul este specificat ca ir gol, semnalul este trimis sesiunilor utilizatorului care invoca comanda. Adaugata in versiunea 233. Comenzi aezare list-seats Listeaza locurile disponibile in prezent pe sistemul local. Formatul de ieire JSON poate fi selectat folosind opiunea --json= sau -j. seat-status [NUME...] Afieaza informaii laconice despre starea de funcionare a unuia sau mai multor locuri. Primete unul sau mai multe nume de locuri ca parametrii. Daca nu sunt trecute nume de locuri, se afieaza starea locului din sesiunea apelantului. Aceasta funcie este menita sa genereze rezultate care pot fi citite de catre persoane. Daca dorii sa obinei un rezultat analizabil de calculator, utilizai in schimb show-seat. Adaugata in versiunea 233. show-seat [NUME...] Afieaza proprietaile unuia sau mai multor locuri sau ale gestionarului insui&. Daca nu este specificat niciun argument, vor fi afiate proprietaile gestionarului. Daca este specificat un loc, sunt afiate proprietaile locului respectiv. In mod implicit, proprietaile goale sunt eliminate. Utilizai --all pentru a le afia i pe acelea. Pentru a selecta anumite proprietai de afiat, utilizai --property=. Aceasta comanda este destinata a fi utilizata ori de cate ori este necesara o ieire care poate fi analizata de calculator. Utilizai seat-status daca dorii o ieire formatata care poate fi citita de persoane. Adaugata in versiunea 233. attach NUME DISPOZITIV... Ataeaza permanent unul sau mai multe dispozitive la un loc. Dispozitivele trebuie specificate prin intermediul rutelor dispozitivelor din sistemul de fiiere ,,/sys/". Pentru a crea un loc nou, ataai cel puin o placa grafica la un nume de loc neutilizat anterior. Numele locurilor pot fi formate numai din a-z, A-Z, 0-9, ,,-" i ,,_" i trebuie precedate de ,,seat". Pentru a renuna la atribuirea unui dispozitiv unui anumit loc, este suficient sa il reatribuii unui alt loc sau sa utilizai flush-devices. Adaugata in versiunea 233. flush-devices Elimina toate alocarile de dispozitive create anterior cu attach. Dupa acest apel, vor ramane doar locurile generate automat, carora li se atribuie tot hardware-ul pentru locuri. terminate-seat NUME... Termina toate sesiunile de pe un loc. Aceasta oprete toate procesele tuturor sesiunilor de pe loc i elibereaza toate resursele alocate de timp de execuie ataate acestora. Adaugata in versiunea 233. OPIUNI Urmatoarele opiuni sunt inelese: -p, --property= La afiarea proprietailor sesiunii/utilizatorului/locului, limiteaza afiarea la anumite proprietai specificate ca argument. Daca nu este specificat, sunt afiate toate proprietaile setului. Argumentul trebuie sa fie un nume de proprietate, cum ar fi ,,Sessions". Daca este specificat de mai multe ori, sunt afiate toate proprietaile cu numele specificate. --value Cand se afieaza proprietaile sesiunii/utilizatorului/locului, afieaza numai valoarea i omite numele proprietaii i ,,=". Adaugata in versiunea 230. -a, --all Cand se afieaza proprietaile sesiunii/utilizatorului/locului, se afieaza toate proprietaile, indiferent daca acestea sunt definite sau nu. -l, --full Nu elipseaza intrarile din arborele de procese. Adaugata in versiunea 198. --kill-whom= Cand este utilizata cu kill-session, alege ce procese sa omoare. Accepta una dintre variantele ,,leader" sau ,,all", pentru a selecta daca sa omoare doar procesul lider al sesiunii sau toate procesele sesiunii. Daca este omisa, valoarea implicita este all. Adaugata in versiunea 252. -s, --signal= Cand este utilizata cu kill-session sau kill-user, alege ce semnal sa trimita proceselor selectate. Trebuie sa fie unul dintre specificatorii de semnal bine cunoscui, cum ar fi SIGTERM, SIGINT sau SIGSTOP. Daca este omis, valoarea implicita este SIGTERM. Valoarea speciala ,,help" va enumera valorile cunoscute i programul va iei imediat, iar valoarea speciala ,,list" va enumera valorile cunoscute impreuna cu numerele numerice ale semnalelor i programul va iei imediat&. -n, --lines= Cand este utilizata cu user-status i session-status, controleaza numarul de linii de jurnal care trebuie afiate, incepand cu cele mai recente. Preia un argument intreg pozitiv. Valoarea implicita este 10. Adaugata in versiunea 219. -o, --output= Cand este utilizata cu user-status i session-status, controleaza formatarea inregistrarilor din jurnal care sunt afiate. Pentru opiunile disponibile, consultai journalctl(1). Valoarea implicita este ,,short" (scurt). Adaugata in versiunea 219. -H, --host= Executai operaia de la distana. Specificai un nume de gazda sau un nume de utilizator i un nume de gazda separate prin ,,@", pentru a va conecta. Numele de gazda poate fi opional sufixat de un port pe care asculta ssh, separat prin ,,:", i apoi de un nume de container, separat prin ,,/", care se conecteaza direct la un container specific de pe gazda specificata. Aceasta va folosi SSH pentru a comunica cu instana managerului mainii la distana. Numele containerelor pot fi enumerate cu machinectl -H HOST. Punei adresele IPv6 in paranteze drepte. -M, --machine= Executarea operaiei pe un container local. Specificai un nume de container la care sa va conectai, prefixat opional de un nume de utilizator cu care sa va conectai i de un caracter de separare ,,@". Daca irul special ,,.host" este utilizat in locul numelui containerului, se realizeaza o conexiune la sistemul local (ceea ce este util pentru a se conecta la un anumit utilizator <>: ,,--user --machine=lennart@.host"). Daca nu se folosete sintaxa ,,@", conexiunea se face ca utilizator root. In cazul in care se utilizeaza sintaxa ,,@", fie partea stanga, fie partea dreapta poate fi omisa (dar nu ambele), caz in care numele de utilizator local i ,,.host" sunt implicite. --no-ask-password Nu solicita autentificarea utilizatorului pentru operaii privilegiate. --no-pager Nu canalizeaza (pipe) ieirea catre un paginator. --no-legend Nu se imprima legenda, titlurile de coloana i subsolul cu indicii. --json=MODUL Afieaza ieirea formatata ca JSON. Ateapta una dintre urmatoarele variante: short" (pentru o ieire cat mai scurta posibil, fara spaii albe sau pauze de linie redundante), ,,pretty" (pentru o versiune placuta a acesteia, cu indentare i pauze de linie) sau ,,off" (pentru a dezactiva ieirea JSON, implicit). -j Echivalent cu --json=pretty daca ruleaza pe un terminal i --json=short altfel. -h, --help Afieaza acest mesaj de ajutor i iese. --version Afieaza informaiile despre versiune i iese. STARE DE IEIRE In caz de succes, se returneaza 0, iar in caz contrar se returneaza un cod de eec diferit de zero.. EXEMPLE Exemplul 1. Consultarea starii utilizatorului $ loginctl user-status fatima (1005) Since: Sat 2016-04-09 14:23:31 EDT; 54min ago State: active Sessions: 5 *3 Unit: user-1005.slice user@1005.service ... session-3.scope ... session-5.scope 3473 login -- fatima 3515 -zsh Apr 09 14:40:30 laptop login[2325]: pam_unix(login:session): session opened for user fatima by LOGIN(uid=0) Apr 09 14:40:30 laptop login[2325]: LOGIN ON tty3 BY fatima Exista doua sesiuni, 3 i 5. Sesiunea 3 este o sesiune grafica, marcata cu un asterisc. Este prezentat arborele de procesare, inclusiv cele doua unitai de domeniu corespunzatoare i unitatea de gestionare a utilizatorului. MEDIU $SYSTEMD_LOG_LEVEL Nivelul maxim de jurnalizare a mesajelor emise (mesajele cu un nivel de jurnalizare mai mare, adica cele mai puin importante, vor fi suprimate). Accepta o lista de valori separate prin virgule. O valoare poate fi fie una dintre (in ordinea descrescatoare a importanei) emerg, alert, crit, err, warning, notice, info, debug, fie un numar intreg in intervalul 0...7. Pentru mai multe informaii, consultai syslog(3). Fiecare valoare poate fi prefixata opional cu unul dintre console, syslog, kmsg sau journal urmat de doua puncte pentru a stabili nivelul maxim de jurnal pentru acea inta de jurnal specifica (de exemplu, SYSTEMD_LOG_LEVEL=debug,console:info specifica jurnalizarea la nivel de depanare, cu excepia cazului in care se inregistreaza la consola, care ar trebui sa fie la nivel info). Reinei ca nivelul maxim global de jurnalizare are prioritate faa de orice nivel maxim de jurnalizare pentru fiecare inta in parte. $SYSTEMD_LOG_COLOR Un boolean. Daca este adevarat ,,true", mesajele scrise pe tty vor fi colorate in funcie de prioritate. Aceasta configurare este utila numai atunci cand mesajele sunt scrise direct in terminal, deoarece journalctl(1) i alte instrumente care afieaza jurnalele vor colora mesajele in funcie de nivelul de jurnalizare. $SYSTEMD_LOG_TIME Un boolean. Daca este adevarat ,,true", mesajele din jurnalul consolei vor fi prefixate cu un marcaj de timp. Aceasta configurare este utila numai atunci cand mesajele sunt scrise direct in terminal sau intr-un fiier, deoarece journalctl(1) i alte instrumente care afieaza jurnalele vor ataa singure marcajele de timp pe baza metadatelor de intrare. $SYSTEMD_LOG_LOCATION Un boolean. Daca este adevarat ,,true", mesajele vor fi prefixate cu un nume de fiier i un numar de linie din codul sursa de unde provine mesajul. Reinei ca, oricum, locaia jurnalului este adesea ataata ca metadate la intrarile din jurnal. Includerea acesteia direct in textul mesajului poate fi totui convenabila pentru depanarea programelor. $SYSTEMD_LOG_TID Un boolean. Daca este adevarat ,,true", mesajele vor fi prefixate cu identificatorul numeric curent al firului de execuie (TID). Reinei ca aceste informaii sunt ataate oricum ca metadate la intrarile din jurnal&. Includerea acestora direct in textul mesajului poate fi totui convenabila pentru depanarea programelor. $SYSTEMD_LOG_TARGET Destinaia pentru mesajele de jurnal. Una dintre urmatoarele opiuni: console (jurnal catre tty-ul ataat), console-prefixed (jurnal catre tty-ul ataat, dar cu prefixe care codifica nivelul de jurnal i ,,facilitatea", a se vedea syslog(3), kmsg (jurnal catre memoria tampon circulara de jurnal din nucleu), journal (jurnal in jurnal), journal-or-kmsg (jurnal in jurnal daca este disponibil, iar in caz contrar in kmsg), auto (determina automat inta de jurnal corespunzatoare, implicit), null (dezactiveaza ieirea de jurnal). $SYSTEMD_LOG_RATELIMIT_KMSG Daca sa se limiteze ,,ratelimit" (viteza limita) a kmsg sau nu. Preia un boolean. Valoarea implicita este ,,true". Daca este dezactivata, systemd nu va limita viteza mesajelor scrise in kmsg. $SYSTEMD_PAGER Paginatorul care trebuie utilizat atunci cand nu este data opiunea --no-pager; inlocuiete variabila $PAGER. Daca nici $SYSTEMD_PAGER i nici $PAGER nu sunt configurate, se incearca pe rand un set de implementari de paginator bine cunoscute, inclusiv less(1) i more(1), pana cand se gasete una. In cazul in care nu se descopera nici o implementare de paginator, nu se invoca nici un paginator. Configurarea acestei variabile de mediu la un ir de caractere gol sau la valoarea "cat" este echivalenta cu pasarea opiunii --no-pager. Nota: daca $SYSTEMD_PAGERSECURE nu este configurata, $SYSTEMD_PAGER (precum i $PAGER) va fi ignorata in mod silenios. $SYSTEMD_LESS Ignora opiunile transmise catre less (implicit ,,FRSXMK"). Utilizatorii ar putea dori sa modifice in special doua opiuni: K Aceasta opiune indica paginatorului sa iasa imediat cand este apasata combinaia de taste Ctrl+C. Pentru a permite lui less sa gestioneze Ctrl+C el insui, pentru a comuta inapoi la promptul de comanda al paginatorului, dezactivai aceasta opiune. In cazul in care valoarea lui $SYSTEMD_LESS nu include ,,K", iar paginatorul care este invocat este less, Ctrl+C va fi ignorat de executabil i trebuie sa fie gestionat de catre paginator. X Aceasta opiune solicita paginatorului sa nu trimita iruri de iniializare i de anulare a iniializarii ,,termcap" catre terminal. Este definita in mod implicit pentru a permite ca ieirea comenzilor sa ramana vizibila in terminal chiar i dupa ce paginatorul iese. Cu toate acestea, acest lucru impiedica anumite funcionalitai ale paginatorului sa funcioneze, in special ieirea paginata nu poate fi derulata cu ajutorul mouse-ului. Reinei ca definirea variabilei de mediu obinuite $LESS nu are niciun efect pentru invocarile less de catre instrumentele systemd. A se vedea less(1) pentru mai multe informaii. $SYSTEMD_LESSCHARSET Ignora setul de caractere transmis catre less (in mod implicit ,,utf-8", daca terminalul de invocare se determina a fi compatibil UTF-8). Reinei ca definirea variabilei de mediu obinuite $LESSCHARSET nu are niciun efect pentru invocarile less de catre instrumentele systemd. $SYSTEMD_PAGERSECURE Primete un argument boolean. Cand este ,,true" (adevarat), este activat modul ,,securizat" al paginatorului; daca este ,,false" (fals), este dezactivat. Daca $SYSTEMD_PAGERSECURE nu este deloc configurata, modul securizat este activat in cazul in care UID-ul efectiv nu este acelai cu cel al proprietarului sesiunii de conectare, a se vedea geteuid(2) i sd_pid_get_owner_uid(3). In modul securizat, LESSSECURE=1 va fi configurata atunci cand se invoca paginatorul, iar paginatorul va dezactiva comenzile care deschid sau creeaza fiiere noi sau care pornesc subprocese noi. Atunci cand $SYSTEMD_PAGERSECURE nu este deloc configurata, paginatoarele despre care nu se tie ca implementeaza modul securizat nu vor fi utilizate (in prezent, numai less(1) implementeaza modul securizat). Nota: atunci cand comenzile sunt invocate cu privilegii ridicate, de exemplu, cu sudo(8) sau pkexec(1), trebuie avut grija sa se asigure ca nu sunt activate caracteristici interactive neintenionat&. Modul ,,securizat" pentru paginator poate fi activat in mod automat, dupa cum se descrie mai sus. Configurarea SYSTEMD_PAGERSECURE=0 sau neeliminarea acestei variabile din mediul motenit permite utilizatorului sa invoce comenzi arbitrare. Reinei ca, pentru ca variabilele $SYSTEMD_PAGER sau $PAGER sa fie onorate, $SYSTEMD_PAGERSECURE trebuie sa fie configurata i ea. Ar putea fi rezonabil sa se dezactiveze complet paginatorul folosind --no-pager in loc. $SYSTEMD_COLORS Primete un argument boolean. Cand este ,,true" (adevarat), systemd i utilitaile aferente vor folosi culori in rezultatul lor, in caz contrar rezultatul va fi monocrom. In plus, variabila poate lua una dintre urmatoarele valori speciale: ,,16", ,,256" pentru a restriciona utilizarea culorilor la baza 16 sau 256 de culori ANSI, respectiv. Acest lucru poate fi specificat pentru a anula decizia automata bazata pe $TERM i la care este conectata consola. $SYSTEMD_URLIFY Valoarea trebuie sa fie un boolean. Controleaza daca trebuie sa se genereze legaturi pe care se poate face clic in emulatoarele de terminal care accepta acest lucru. Acest lucru poate fi specificat pentru a anula decizia pe care systemd o ia pe baza $TERM i a altor condiii. CONSULTAI I systemd(1), systemctl(1), systemd-logind.service(8), logind.conf(5) TRADUCERE Traducerea in limba romana a acestui manual a fost facuta de Remus- Gabriel Chelu Aceasta traducere este documentaie gratuita; citii Licena publica generala GNU Versiunea 3 sau o versiune ulterioara cu privire la condiii privind drepturile de autor. NU se asuma NICIO RESPONSABILITATE. Daca gasii erori in traducerea acestui manual, va rugam sa trimitei un e-mail la . systemd 257 LOGINCTL(1)