Difference between revisions of "Nmcli"

From ICO wiki
 
(47 intermediate revisions by the same user not shown)
Line 2: Line 2:
  
  
nmcli on käsurea tööriist, mille abil saab kontrollida NetworkManageri ja pärida selle staatust. See ei ole mõeldud asendamiseks mõnda nm-applet või muid sarnaseid programme. Pigem on see mõeldud täiendavaks nendele programmidele. Peamiselt leiab nmcli kasutatavust serverites, iseseisvale masinale või lihtsalt edasijõudnud kasutajatele, kes eelistavad kasutada käsurida.
+
Nmcli on käsurea tööriist, mille abil saab kontrollida NetworkManageri ja pärida selle poolt hallatavate ühenduste staatuseid. See ei ole mõeldud asendamiseks mõnda nm-applet või muid sarnaseid programme. Pigem on see mõeldud täiendavaks kasutamiseks koos nende programmidega.  
 +
=Käsu süntaks=
  
= Erinevaid kasutusviise =
+
      nmcli [OPTIONS] OBJECT { COMMAND | help }
  
1) Initskriptit: ifup / ifdown saab kasutada nmcli kaudu Network managerile ligi pääsemiseks, selle asemel, et hallata ühendusi ise ja segada NetworkManageri tööd.
+
OPTIONS
 +
  -t[erse]                                  terse output
 +
  -p[retty]                                  pretty output
 +
  -m[ode] tabular|multiline                  output mode
 +
  -f[ields] <field1,field2,...>|all|common  specify fields to output
 +
  -e[scape] yes|no                          escape columns separators in values
 +
  -n[ocheck]                                don't check nmcli and NetworkManager versions
 +
  -v[ersion]                                show program version
 +
  -h[elp]                                    print this help
  
 +
OBJECT
 +
  nm          NetworkManager status
 +
  con        NetworkManager connections
 +
  dev        devices managed by NetworkManager
  
2) Servereid, peata masinaid, millel puudub graafiline liides, siis kasutatakse nmcli-d et rääkida otse NetworkManageri ja kontrollida kogu süsteemi ühendusi.
 
  
3)
+
[http://docs.fedoraproject.org/en-US/Fedora/13/html/User_Guide/sect-User_Guide-Connecting_to_the_Internet-NM_CLI.html]
Kristian Kivimägi A22
 
  
 +
=Nmcli kasutamine=
  
=SYNOPSIS=
+
==  nm ehk NetworkManager  ==
      nmcli  [ OPTIONS ] OBJECT { COMMAND | help }
+
* <u>Kasutage seda objekti, et uurida ja muuta NetworkManageri staatuseid.</u>
  
      OBJECT := { nm | con | dev }
+
<pre>
 +
nmcli nm  status
 +
</pre>
 +
<u>Tulemus:</u> Käsk näitab üldist NetworkManageri staatust.
 +
<pre>
 +
nmcli nm sleep
 +
</pre>
 +
<u>Tulemus:</u> See käsk lükkab NetworkManageri une režiimi. Seega kõik liidesed, mida NetworkManager haldab lülitatakse välja.
 +
<pre>
 +
nmcli nm wakeup
 +
</pre>
 +
<u>Tulemus:</u> Käsk äratab NetworkManageri une režiimist. Kõik liidesed on nüüd võimalik samuti aktiveerida.
 +
<pre>
 +
nmcli nm wifi [on|off]
 +
</pre>
 +
<u>Tulemus:</u> Käsk lülitab Wifi sisse või välja. Märkus, kui päringust [on|off], ära jätta siis tagastatakse Wifi-i hetke staatus.
 +
<pre>
 +
nmcli nm wwan [on|off]
 +
</pre>
 +
<u>Tulemus:</u> Käsk lülitab WWAN-i välja või sisse. Märkus, kui päringust [on|off], ära jätta siis tagastatakse WWAN-i hetke staatus.
 +
[http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html]
 +
==con ehk Connections==
 +
* <u> Kasutage seda objekti, et pärida informatsiooni NetworkManageri ühenduste kohta.</u>
 +
<pre>
 +
nmcli con list
 +
</pre>
 +
<u>Tulemus:</u> Käsk väljastab seadistatud ühendused, nii kasutaja poolsed, kui ka süsteemi seadistused. Kui soov on vähendada tulemusi ning saada vaid mõni spetsiifiline konfiguratsioon tuleks lõppu lisada vastav parameeter: [id <id> | uuid <id> | system | user]
 +
<pre>
 +
nmcli con status
 +
</pre>
 +
<u>Tulemus:</u> Käsk väljastab kõik aktiivsed ühendused
 +
<pre>
 +
up id <id>
 +
</pre>
 +
<u>Tulemus:</u> Käsu abil saab aktiveerida ühenduse. Märkus ühenduse aktiveerimiseks peab <id> asemele kirjutama ühenduse ID.
  
      OPTIONS := {
+
<pre>
      -t[erse]
+
down id <id>
      -p[retty]
+
</pre>
      -m[mode] tabular | multiline
+
<u>Tulemus:</u> Käsu abil saab deaktiveerida ühenduse. Märkus ühenduse aktiveerimiseks peab <id> asemele kirjutama ühenduse ID
      -f[ields] <field1,field2,...> | all | common
+
[http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html]
      -e[scape] yes | no
+
==dev ehk Devices==
      -v[ersion]
+
* <u>Kasutage seda objekti, et saada informatsiooni seadmete kohta.</u>
      -h[elp]
+
<pre>
      }
+
nmcli dev status
 +
</pre>
 +
<u>Tulemus:</u> Käsk näitab seadmete kohta informatsiooni.
  
==OPTIONS==
+
Näide:
       -t, --terse
+
<pre>
              Output is terse.  This mode is designed and suitable for
+
DEVICE    TYPE              STATE        
              computer (script) processing.
+
wlan0      802-11-wireless  connected   
 +
eth0      802-3-ethernet    unavailable
 +
</pre>
  
      -p, --pretty
+
<pre>
              Output is prettyThis causes nmcli to produce easy readable
+
nmcli dev list [iface <iface>]
              outputs for humans, i.e. values are aligned, headers are
+
</pre>
              printed, etc.
+
<u>Tulemus:</u> Käsk väljastab detailse informatsiooni tabeli seadmete kohta. Märkus, et saada detailset informatsiooni vaid ühe kindla liidese kohta siis tuleb lisada käsu lõppu iface <iface>, ning <iface> asemele tuleb kirjutada kindla liidese nimi.
 +
<pre>
 +
nmcli dev  disconnect iface <iface>
 +
</pre>
 +
<u>Tulemus:</u> Käsk katkestab ühenduse ühe kindla liidesega, <iface> asemele tuleb lisada liidese nimi.
 +
<pre>
 +
nmcli dev wifi
 +
</pre>
 +
<u>Tulemus:</u> Käsk väljastab kõik Wifi põõrduspunktid. Märkus, kui on soovi saada informatsiooni vaid mõne kindla pöörduspunkti kohta, tuleb lõppu lisada: [list [iface <iface>] [hwaddr <hwaddr>]]. <iface> asemele lisada liidese nimi ning <hwaddr> asemele pöörduspunkti nimi.
 +
[http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html]
 +
==Kokkuvõte==
  
      -m, --mode tabular | multiline
+
Nmcli abil saab hõlpsasti lülitada välja arvutiga seotuid erinevaid ühendusi ning pärida nende kohta informatsiooni. See NetworkManageri liides peaks rahuldama ka kõige nõudlikumad kasutajad, olgu siis selleks kas tavakasutaja või serveri administraator.
              Switch between tabular and multiline output.  If omitted,
 
              default is tabular for most commands.  For the commands
 
              producing more structured information, that cannot be displayed
 
              on a single line, default is multiline. Currenly, they are:
 
                'nmcli con list id|uuid <name>'
 
                'nmcli dev list'
 
              tabular  - Output is a table where each line describes a single
 
              entry.  Columns define particular properties of the entry.
 
              multiline - Each entry comprises more lines, each property on
 
              its own line.  The values are prefixed with the property name.
 
  
      -f, --fields <field1,field2,...> | all | common
+
==Kasutatud kirjandus==
              This option is used to specify what fields (column names) should
 
              be printed.  Valid field names differ for specific commands.
 
              List available fields by providing an invalid value to the
 
              --fields option.
 
              all is used to print all valid field values of the command.
 
              common is used to print common field values of the command.  If
 
              omitted, default is common.  The option is mandatory when
 
              --terse is used.  In this case, generic values all and common
 
              cannot be used.  (This is to maintain compatibility when new
 
              fields are added in the future).
 
  
      -e, --escape yes | no
+
http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html <br/>
              Whether to escape ':' and '\' characters in terse tabular mode.
 
              The escape character is '\'. If omitted, default is yes.
 
  
      -v, --version
+
http://docs.fedoraproject.org/en-US/Fedora/13/html/User_Guide/sect-User_Guide-Connecting_to_the_Internet-NM_CLI.html <br/>
              Show nmcli version.
 
  
      -h, --help
+
== Koostas ==
              Print help information.
+
Kristian Kivimägi A22 sügis 2012
 +
 
 +
Esitatud: 02.12.12
 +
 
 +
Muudetud: 03.01.13
 +
 
 +
[[Category:Operatsioonisüsteemide administreerimine ja sidumine]]

Latest revision as of 12:58, 4 January 2013

Sissejuhatus

Nmcli on käsurea tööriist, mille abil saab kontrollida NetworkManageri ja pärida selle poolt hallatavate ühenduste staatuseid. See ei ole mõeldud asendamiseks mõnda nm-applet või muid sarnaseid programme. Pigem on see mõeldud täiendavaks kasutamiseks koos nende programmidega.

Käsu süntaks

     nmcli [OPTIONS] OBJECT { COMMAND | help }

OPTIONS

 -t[erse]                                   terse output
 -p[retty]                                  pretty output
 -m[ode] tabular|multiline                  output mode
 -f[ields] <field1,field2,...>|all|common   specify fields to output
 -e[scape] yes|no                           escape columns separators in values
 -n[ocheck]                                 don't check nmcli and NetworkManager versions
 -v[ersion]                                 show program version
 -h[elp]                                    print this help

OBJECT

 nm          NetworkManager status
 con         NetworkManager connections
 dev         devices managed by NetworkManager


[1]

Nmcli kasutamine

nm ehk NetworkManager

  • Kasutage seda objekti, et uurida ja muuta NetworkManageri staatuseid.
nmcli nm  status

Tulemus: Käsk näitab üldist NetworkManageri staatust.

nmcli nm sleep

Tulemus: See käsk lükkab NetworkManageri une režiimi. Seega kõik liidesed, mida NetworkManager haldab lülitatakse välja.

nmcli nm wakeup

Tulemus: Käsk äratab NetworkManageri une režiimist. Kõik liidesed on nüüd võimalik samuti aktiveerida.

nmcli nm wifi [on|off]

Tulemus: Käsk lülitab Wifi sisse või välja. Märkus, kui päringust [on|off], ära jätta siis tagastatakse Wifi-i hetke staatus.

nmcli nm wwan [on|off]

Tulemus: Käsk lülitab WWAN-i välja või sisse. Märkus, kui päringust [on|off], ära jätta siis tagastatakse WWAN-i hetke staatus. [2]

con ehk Connections

  • Kasutage seda objekti, et pärida informatsiooni NetworkManageri ühenduste kohta.
nmcli con  list

Tulemus: Käsk väljastab seadistatud ühendused, nii kasutaja poolsed, kui ka süsteemi seadistused. Kui soov on vähendada tulemusi ning saada vaid mõni spetsiifiline konfiguratsioon tuleks lõppu lisada vastav parameeter: [id <id> | uuid <id> | system | user]

nmcli con status

Tulemus: Käsk väljastab kõik aktiivsed ühendused

up id <id>

Tulemus: Käsu abil saab aktiveerida ühenduse. Märkus ühenduse aktiveerimiseks peab <id> asemele kirjutama ühenduse ID.

down id <id>

Tulemus: Käsu abil saab deaktiveerida ühenduse. Märkus ühenduse aktiveerimiseks peab <id> asemele kirjutama ühenduse ID [3]

dev ehk Devices

  • Kasutage seda objekti, et saada informatsiooni seadmete kohta.
nmcli dev status

Tulemus: Käsk näitab seadmete kohta informatsiooni.

Näide:

DEVICE     TYPE              STATE        
wlan0      802-11-wireless   connected    
eth0       802-3-ethernet    unavailable 
nmcli dev list [iface <iface>]

Tulemus: Käsk väljastab detailse informatsiooni tabeli seadmete kohta. Märkus, et saada detailset informatsiooni vaid ühe kindla liidese kohta siis tuleb lisada käsu lõppu iface <iface>, ning <iface> asemele tuleb kirjutada kindla liidese nimi.

nmcli dev  disconnect iface <iface> 

Tulemus: Käsk katkestab ühenduse ühe kindla liidesega, <iface> asemele tuleb lisada liidese nimi.

nmcli dev wifi

Tulemus: Käsk väljastab kõik Wifi põõrduspunktid. Märkus, kui on soovi saada informatsiooni vaid mõne kindla pöörduspunkti kohta, tuleb lõppu lisada: [list [iface <iface>] [hwaddr <hwaddr>]]. <iface> asemele lisada liidese nimi ning <hwaddr> asemele pöörduspunkti nimi. [4]

Kokkuvõte

Nmcli abil saab hõlpsasti lülitada välja arvutiga seotuid erinevaid ühendusi ning pärida nende kohta informatsiooni. See NetworkManageri liides peaks rahuldama ka kõige nõudlikumad kasutajad, olgu siis selleks kas tavakasutaja või serveri administraator.

Kasutatud kirjandus

http://manpages.ubuntu.com/manpages/maverick/man1/nmcli.1.html

http://docs.fedoraproject.org/en-US/Fedora/13/html/User_Guide/sect-User_Guide-Connecting_to_the_Internet-NM_CLI.html

Koostas

Kristian Kivimägi A22 sügis 2012

Esitatud: 02.12.12

Muudetud: 03.01.13