Aus SETI.Germany Wiki

Das BOINC Kommandozeilen-Wekzeug

Das BOINC Kommandozeilen-Wekzeug (boinccmd) stellt eine Kommandozeilen-Schnittstelle für den Remotezugriff auf einen laufenden BOINC-Client bereit. boinccmd hat folgende Syntax:

boinccmd [--host hostname] [--passwd passwd] command

Verbindung zum Core Client

--host hostname[:port]

Der Rechner, mit dem verbunden werden soll (Standard: localhost)

--passwd

Das Password für den Remotezugriff (Standard: boinccmd sucht nach der Datei gui_rpc_auth.cfg und nutzt das darin enthaltene Passwort)

Konto-Abfrage und Anmeldung

--lookup_account URL email password

Sucht ein Konto und gibt den Account-Key aus

--create_account URL email password name

Erstellt ein Konto mit der angegebenen E-Mail-Adresse, dem Passwort und Benutzernamen

--project_attach URL auth

Bei einem Projekt anmelden

--join_acct_mgr URL name password

Bei einer Kontoverwaltung anmelden (oder führt eine Aktualisierung aus, falls bereits angemeldet)

--quit_acct_mgr

Bei dre aktuellen Kontoverwaltung abmelden

Status-Abfragen

--get_state

Zeigt den kompletten Client-Status

--get_results

Zeigt die Results

--get_simple_gui_info

Zeigt die Projekte und die aktiven Results

--get_file_transfers

Zeigt die Dateiübertragungen

--get_project_status

Zeigt den Status aller Projekte

--get_disk_usage

Zeigt den Festplatten-Verbrauch je Projekt

--get_proxy_settings

Zeigt die Proxy-Einstellungen

--get_messages seqno

Zeigt die Messages mit Sequenznummern ab der angegebenen Sequenznummer (seqno)

--get_host_info

Zeigt die Rechner-Informationen

--get_screensaver_mode
--version, -V

Show core client version

Kontrollfunktionen

--result URL result_name Funktion
  {--window_station ws} {--desktop dt} {--display dp}

Führt Funktionen bei einem Result aus, das durch die angegebene Projekt-URL und den Result-Namen identifiziert wird

Funktionen:

• suspend: Bearbeitung des Results temporär unterbrechen
• resume: Bearbeitung des Results (wieder) erlauben
• abort: Bearbeitung des Results komplett beenden
• graphics_window: Öffnet Grafiken in neuem Fenster: Die optionalen Parameter desktop/window_station (Windows) oder display (X11) geben an, welches Display genutzt werden soll
• graphics_fullscreen: Öffnet Grafik als Vollbild

--project URL Funktion

Führt Funktionen bei einem Projekt aus, das durch die angegebene Projekt-URL identifiziert wird

Funktionen:

• reset: Alle Aufgaben löschen und weitere Aufgaben holen
• detach: Alle Aufgaben löschen und keine weiteren Aufgaben holen
• update: Kontaktiere den Scheduler-Server
• suspend: Bearbeitung des Projekts anhalten
• result: Bearbeitung des Projekts fortsetzen
• nomorework: Aktuelle Aufgaben beenden, aber keine weitere Arbeit holen
• allowmorework: hebt nomorework wieder auf
• detach_when_done: Bei Projekt abmelden, nachdem alle Aufgaben erledigt wurden

--file_transfer URL filename {retry | abort}

Funktion bei einer Dateiübertragung ausführen (nochmals versuchen | abbrechen)

--set_run_mode {always | auto | never} [ Dauer ]

Stellt den Arbeits-Modus ein

* always: immer Aufgaben bearbeiten

* auto: nur Aufgaben bearbeiten, wenn es die Voreinstellungen (preferences) gestatten

* never: keine Aufgaben bearbeiten

Wenn bei Dauer nichts oder 0 angegeben ist, gilt der eingestellte Modus permanent. Ist eine Dauer angegeben, kehrt der Client nach dieser Anzahl Sekunden zurück zum letzten eingestellten Modus.

--set_network_mode {always | auto | never} [ Dauer ]

Stellt den Netzwerk-Modus ein

Wie bei set_run_mode, gilt jedoch für Netzwerkübertragungen

--set_proxy_settings http_server_name http_server_port http_user_name http_user_passwd 
socks_server_name socks_server_port socks_version socks5_user_name socks5_user_passwd

Setzt die Proxy-Einstellungen (alle Felder sind anzugeben)

--run_benchmarks

Führt die CPU-Benchmarks aus

--set_screensaver_mode on|off blank_time
  {--desktop desktop} {--window_station window_station} {--display display}

Weist den Client an, Grafiken im Vollbild-Modus auszuführen und nach blank_time Sekunden den Bildschirm abzuschalten. Die optionalen Parameter geben an, welcher desktop/windows_station (Windows) oder welches Display (X11) genutzt werden soll.

--read_global_prefs_override

Weist den Client an, die Datei global_prefs_override.xml einzulesen und alle dort angegebenen Einstellungen von dort zu nutzen.

--quit

Weist den Client an, sich zu beenden

--read_cc_config

Liest die Konfigurationsdatei erneut ein.

--set_debts URL1 STD1 LTD1 {URL2 STD2 LTD2 ...}

Setzt die short- und long-term debts Von einem oder mehreren Projekten.

Hinweis: Wenn die debts von einem Projekt verändert werden, verändern sich auch die debts der anderen Projekte,

wenn also die debts von mehreren Projekten verändert werden sollen, ist es besser, alles in einem Befehl zu erledigen.

Verschiedenes

--help, -h

Zeigt Optionen und Befehle

Weblinks

BOINC-Wiki zum boinccmd-Tool