Snapshots (Schnappschüsse)

Snapshots sind Server-Abbilder in Textform. Der Zeichensatz ist CESU-8 bzw. UTF-8.

Was ist drin?

• Einstellungen des virtuellen Servers (außer Port) inkl. Keypair
• Channel
• Client-Datenbank
• Rechte von lokalen Gruppen (beide Arten), Clients (beide Arten) und Channels
• Gruppen-Zuordnungen

Was ist nicht drin?

• Server-Port (wird beim Einspielen automatisch vergeben)
• Dateien
• Bans
• Beschwerden
• Offline-Nachrichten (aber Anzahl der ungelesenen Nachrichten für jeden Client, auch wenn man die Nachrichten nach dem Einspielen nicht mehr lesen kann)

Format

Zwischen den in den Tabellenzeilen dargestellten Parametern gehört ein Leerzeichen. Parameter, die anders als sonst heißen, sind fettgedruckt dargestellt.

• hash=
• Base64-kodierter SHA-1 der restlichen Daten hinter dem (also ohne den) folgenden Senkrechtstrich bis zum Ende (ohne eventuellen Absatz)
• |

• Snapshot-Feld	zum Vergleich: serverinfo
  virtualserver_unique_identifier (hat keine Funktion)	virtualserver_unique_identifier
  virtualserver_name	virtualserver_name
  virtualserver_welcomemessage	virtualserver_welcomemessage
  	virtualserver_platform
  	virtualserver_version
  virtualserver_maxclients	virtualserver_maxclients
  virtualserver_password	virtualserver_password
  	virtualserver_clientsonline
  	virtualserver_channelsonline
  virtualserver_created	virtualserver_created
  	virtualserver_uptime
  virtualserver_codec_encryption_mode	virtualserver_codec_encryption_mode
  virtualserver_keypair (daraus wird die UID berechnet)
  virtualserver_hostmessage	virtualserver_hostmessage
  virtualserver_hostmessage_mode	virtualserver_hostmessage_mode
  virtualserver_filebase (hat keine Funktion)	virtualserver_filebase
  virtualserver_default_server_group	virtualserver_default_server_group
  virtualserver_default_channel_group	virtualserver_default_channel_group
  virtualserver_flag_password	virtualserver_flag_password
  virtualserver_default_channel_admin_group	virtualserver_default_channel_admin_group
  virtualserver_max_download_total_bandwidth	virtualserver_max_download_total_bandwidth
  virtualserver_max_upload_total_bandwidth	virtualserver_max_upload_total_bandwidth
  virtualserver_hostbanner_url	virtualserver_hostbanner_url
  virtualserver_hostbanner_gfx_url	virtualserver_hostbanner_gfx_url
  virtualserver_hostbanner_gfx_interval	virtualserver_hostbanner_gfx_interval
  virtualserver_complain_autoban_count	virtualserver_complain_autoban_count
  virtualserver_complain_autoban_time	virtualserver_complain_autoban_time
  virtualserver_complain_remove_time	virtualserver_complain_remove_time
  virtualserver_min_clients_in_channel_before_forced_silence	virtualserver_min_clients_in_channel_before_forced_silence
  virtualserver_priority_speaker_dimm_modificator	virtualserver_priority_speaker_dimm_modificator
  	virtualserver_id
  virtualserver_antiflood_points_tick_reduce	virtualserver_antiflood_points_tick_reduce
  virtualserver_antiflood_points_needed_command_block	virtualserver_antiflood_points_needed_command_block
  virtualserver_antiflood_points_needed_ip_block	virtualserver_antiflood_points_needed_ip_block
  	virtualserver_client_connections
  	virtualserver_query_client_connections
  virtualserver_hostbutton_tooltip	virtualserver_hostbutton_tooltip
  virtualserver_hostbutton_url	virtualserver_hostbutton_url
  virtualserver_hostbutton_gfx_url	virtualserver_hostbutton_gfx_url
  	virtualserver_queryclientsonline
  virtualserver_download_quota	virtualserver_download_quota
  virtualserver_upload_quota	virtualserver_upload_quota
  	virtualserver_month_bytes_downloaded
  	virtualserver_month_bytes_uploaded
  	virtualserver_total_bytes_downloaded
  	virtualserver_total_bytes_uploaded
  	virtualserver_port
  	virtualserver_autostart
  	virtualserver_machine_id
  virtualserver_needed_identity_security_level	virtualserver_needed_identity_security_level
  virtualserver_log_client	virtualserver_log_client
  virtualserver_log_query	virtualserver_log_query
  virtualserver_log_channel	virtualserver_log_channel
  virtualserver_log_permissions	virtualserver_log_permissions
  virtualserver_log_server	virtualserver_log_server
  virtualserver_log_filetransfer	virtualserver_log_filetransfer
  virtualserver_min_client_version	virtualserver_min_client_version
  virtualserver_name_phonetic	virtualserver_name_phonetic
  virtualserver_icon_id	virtualserver_icon_id
  virtualserver_reserved_slots	virtualserver_reserved_slots
  	virtualserver_total_packetloss_speech
  	virtualserver_total_packetloss_keepalive
  	virtualserver_total_packetloss_control
  	virtualserver_total_packetloss_total
  	virtualserver_total_ping
  	virtualserver_ip
  virtualserver_weblist_enabled	virtualserver_weblist_enabled
  	virtualserver_ask_for_privilegekey
  virtualserver_hostbanner_mode	virtualserver_hostbanner_mode
  virtualserver_channel_temp_delete_delay_default	virtualserver_channel_temp_delete_delay_default
  virtualserver_min_android_version	virtualserver_min_android_version
  virtualserver_min_ios_version	virtualserver_min_ios_version
  	virtualserver_status
  	connection_filetransfer_bandwidth_sent
  	connection_filetransfer_bandwidth_received
  	connection_filetransfer_bytes_sent_total
  	connection_filetransfer_bytes_received_total
  	connection_packets_sent_speech
  	connection_bytes_sent_speech
  	connection_packets_received_speech
  	connection_bytes_received_speech
  	connection_packets_sent_keepalive
  	connection_bytes_sent_keepalive
  	connection_packets_received_keepalive
  	connection_bytes_received_keepalive
  	connection_packets_sent_control
  	connection_bytes_sent_control
  	connection_packets_received_control
  	connection_bytes_received_control
  	connection_packets_sent_total
  	connection_bytes_sent_total
  	connection_packets_received_total
  	connection_bytes_received_total
  	connection_bandwidth_sent_last_second_total
  	connection_bandwidth_sent_last_minute_total
  	connection_bandwidth_received_last_second_total
  	connection_bandwidth_received_last_minute_total

•  end_virtualserver|begin_channels 
• Für jeden Channel in Baum-Reihenfolge:

  • Snapshot-Feld	zum Vergleich: channelinfo	zum Vergleich: channellist
    channel_id	(ergibt sich aus dem Parameter cid)	cid
    channel_pid	pid	pid
    channel_name	channel_name	channel_name
    channel_topic	channel_topic	channel_topic (-topic)
    channel_description	channel_description
    channel_password	channel_password
    channel_codec	channel_codec	channel_codec (-voice)
    channel_codec_quality	channel_codec_quality	channel_codec_quality (-voice)
    channel_maxclients	channel_maxclients	channel_maxclients (-limits)
    channel_maxfamilyclients	channel_maxfamilyclients	channel_maxfamilyclients (-limits)
    channel_order	channel_order	channel_order
    channel_flag_permanent	channel_flag_permanent	channel_flag_permanent (-flags)
    channel_flag_semi_permanent	channel_flag_semi_permanent	channel_flag_semi_permanent (-flags)
    channel_flag_default	channel_flag_default	channel_flag_default (-flags)
    channel_flag_password	channel_flag_password	channel_flag_password (-flags)
    channel_codec_latency_factor	channel_codec_latency_factor
    channel_codec_is_unencrypted	channel_codec_is_unencrypted
    channel_security_salt (neuerdings, leer)	channel_security_salt (leer)
    	channel_delete_delay
    channel_flag_maxclients_unlimited	channel_flag_maxclients_unlimited
    channel_flag_maxfamilyclients_unlimited	channel_flag_maxfamilyclients_unlimited
    channel_flag_maxfamilyclients_inherited	channel_flag_maxfamilyclients_inherited
    channel_filepath (hat keine Funktion)	channel_filepath
    	channel_needed_talk_power	channel_needed_talk_power (-voice)
    	channel_forced_silence
    channel_name_phonetic	channel_name_phonetic
    	channel_icon_id	channel_icon_id (-icon)
    	channel_flag_private
    	seconds_empty	seconds_empty (-secondsempty)
    		total_clients
    		total_clients_family (-limits)
    		channel_needed_subscribe_power

  • |
• end_channels|begin_clients 
• Für jeden Client in Erstellreihenfolge:

  • Snapshot-Feld	zum Vergleich: clientdblist
    client_id	cldbid
    client_unique_id	client_unique_identifier
    client_nickname	client_nickname
    client_created	client_created
    client_lastconnected (seit 3.3.0)	client_lastconnected
    client_totalconnections (seit 3.3.1)	client_totalconnections
    client_description	client_description
    	client_lastip
    client_unread_messages	(sollte man eh auf 0 setzen, da die Nachrichten fehlen)

  • |
• end_clients|begin_permissions|server_groups 
• Für jede lokale (Typ 1) Server-Gruppe in Erstellreihenfolge:

  • Snapshot-Feld	zum Vergleich: servergrouplist
    id	sgid
    name	name

  •  
  • Für jedes Recht in Baum-Reihenfolge:

    • Snapshot-Feld	zum Vergleich: servergrouppermlist -permsid
      permid	permsid
      permvalue	permvalue
      permnegated	permnegated
      permskip	permskip

      Anmerkung: Beim Snapshot kommt permskip vor permnegated, bei servergrouppermlist ist es andersherum.
    • |
  • end_group|
• end_groups|iid=0 
• Für jede Servergruppen-Mitgliedschaft sortiert nach Client-Datenbank-ID (und bei Gleichstand nach Servergruppen-ID):

  • Snapshot-Feld	Bedeutung
    cldbid	Client-Datenbank-ID
    gid	Servergruppen-ID

  • |
• end_relations|channel_groups 
• Für jede lokale (Typ 1) Channel-Gruppe in Erstellreihenfolge:

  • Snapshot-Feld	zum Vergleich: channelgrouplist
    id	cgid
    name	name

  •  
  • Für jedes Recht in Baum-Reihenfolge:

    • Snapshot-Feld	zum Vergleich: channelgrouppermlist -permsid
      permid	permsid
      permvalue	permvalue
      permnegated	permnegated
      permskip	permskip

      Anmerkung: Beim Snapshot kommt permskip vor permnegated, bei channelgrouppermlist ist es andersherum.
    • |
  • end_group|
• end_groups|
• Für jede Channelgruppen-Mitgliedschaft sortiert nach Channel-ID (und bei Gleichstand Client-Datenbank-ID und bei erneutem Gleichstand nach Servergruppen-ID):

  • Snapshot-Feld	zum Vergleich: channelgroupclientlist
    iid (falls anders als zuvor)	cid
    cldbid	cldbid
    gid	cgid

  • |
• end_relations|client_flat 
• Für jedes Client-Recht (Serverebene) sortiert nach Client-Datenbank-ID:

  • Snapshot-Feld	Bedeutung
    id1 (falls anders als zuvor)	Client-Datenbank-ID
    id2 (falls id1 anders als zuvor)	immer 0
    permid	Rechte-Name (permsid)
    permvalue	Rechte-Wert (permvalue)
    permnegated	Negated-Flag (permnegated)
    permskip	Skip-Flag (permskip)

  • |
• end_flat|channel_flat 
• Für jedes Channel-Recht sortiert nach Channel-ID:

  • Snapshot-Feld	Bedeutung
    id1 (falls anders als zuvor)	Channel-ID
    id2 (falls id1 anders als zuvor)	immer 0
    permid	Rechte-Name (permsid)
    permvalue	Rechte-Wert (permvalue)
    permnegated	Negated-Flag (permnegated)
    permskip	Skip-Flag (permskip)

  • |
• end_flat|channel_client_flat 
• Für jedes Client-Recht (Channelebene) sortiert nach Client-Datenbank-ID (bei Gleichstand nach Channel-ID):

  • Snapshot-Feld	Bedeutung
    id1 (falls id1 oder id2 anders als zuvor)	Channel-ID
    id2 (falls id1 oder id2 anders als zuvor)	Client-Datenbank-ID
    permid	Rechte-Name (permsid)
    permvalue	Rechte-Wert (permvalue)
    permnegated	Negated-Flag (permnegated)
    permskip	Skip-Flag (permskip)

  • |
• end_flat|end_permissions