Remmina - The GTK+ Remote Desktop Client  v1.4.34
Remmina is a remote desktop client written in GTK+, aiming to be useful for system administrators and travellers, who need to work with lots of remote computers in front of either large monitors or tiny netbooks. Remmina supports multiple network protocols in an integrated and consistent user interface. Currently RDP, VNC, NX, XDMCP and SSH are supported.
Data Structures | Enumerations | Functions
remmina_file.h File Reference

Go to the source code of this file.

Data Structures

struct  _RemminaFile
 

Enumerations

enum  {
  SSH_AUTH_PASSWORD , SSH_AUTH_PUBLICKEY , SSH_AUTH_AGENT , SSH_AUTH_AUTO_PUBLICKEY ,
  SSH_AUTH_GSSAPI , SSH_AUTH_KBDINTERACTIVE
}
 used in remmina_ssh.c and remmina_ssh_plugin.c More...
 

Functions

RemminaFile * remmina_file_new (void)
 
RemminaFile * remmina_file_copy (const gchar *filename)
 
void remmina_file_generate_filename (RemminaFile *remminafile)
 Generate a new Remmina connection profile file name. More...
 
void remmina_file_set_filename (RemminaFile *remminafile, const gchar *filename)
 
void remmina_file_set_statefile (RemminaFile *remminafile)
 
void remmina_file_state_last_success (RemminaFile *remminafile)
 
const gchar * remmina_file_get_filename (RemminaFile *remminafile)
 
const gchar * remmina_file_get_statefile (RemminaFile *remminafile)
 
RemminaFile * remmina_file_load (const gchar *filename)
 
void remmina_file_set_string (RemminaFile *remminafile, const gchar *setting, const gchar *value)
 
const gchar * remmina_file_get_string (RemminaFile *remminafile, const gchar *setting)
 
gchar * remmina_file_get_secret (RemminaFile *remminafile, const gchar *setting)
 
gchar * remmina_file_format_properties (RemminaFile *remminafile, const gchar *setting)
 
void remmina_file_set_int (RemminaFile *remminafile, const gchar *setting, gint value)
 
gint remmina_file_get_int (RemminaFile *remminafile, const gchar *setting, gint default_value)
 
gdouble remmina_file_get_double (RemminaFile *remminafile, const gchar *setting, gdouble default_value)
 
void remmina_file_store_secret_plugin_password (RemminaFile *remminafile, const gchar *key, const gchar *value)
 
gboolean remmina_file_remove_key (RemminaFile *remminafile, const gchar *setting)
 
void remmina_file_set_state (RemminaFile *remminafile, const gchar *setting, const gchar *value)
 
const gchar * remmina_file_get_state (RemminaFile *remminafile, const gchar *setting)
 
void remmina_file_set_state_int (RemminaFile *remminafile, const gchar *setting, gint value)
 
gint remmina_file_get_state_int (RemminaFile *remminafile, const gchar *setting, gint default_value)
 
gdouble remmina_file_get_state_double (RemminaFile *remminafile, const gchar *setting, gdouble default_value)
 
void remmina_file_save (RemminaFile *remminafile)
 
void remmina_file_free (RemminaFile *remminafile)
 
RemminaFile * remmina_file_dup (RemminaFile *remminafile)
 
const gchar * remmina_file_get_icon_name (RemminaFile *remminafile)
 
RemminaFile * remmina_file_dup_temp_protocol (RemminaFile *remminafile, const gchar *new_protocol)
 
void remmina_file_delete (const gchar *filename)
 
void remmina_file_unsave_passwords (RemminaFile *remminafile)
 
gchar * remmina_file_get_datetime (RemminaFile *remminafile)
 Return the string date of the last time a Remmina state file has been modified. More...
 
void remmina_file_touch (RemminaFile *remminafile)
 Update the atime and mtime of a given filename. More...
 

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

used in remmina_ssh.c and remmina_ssh_plugin.c

#define SSH_AUTH_METHOD_UNKNOWN 0x0000u #define SSH_AUTH_METHOD_NONE 0x0001u #define SSH_AUTH_METHOD_PASSWORD 0x0002u #define SSH_AUTH_METHOD_PUBLICKEY 0x0004u #define SSH_AUTH_METHOD_HOSTBASED 0x0008u #define SSH_AUTH_METHOD_INTERACTIVE 0x0010u #define SSH_AUTH_METHOD_GSSAPI_MIC 0x0020u

Enumerator
SSH_AUTH_PASSWORD 
SSH_AUTH_PUBLICKEY 
SSH_AUTH_AGENT 
SSH_AUTH_AUTO_PUBLICKEY 
SSH_AUTH_GSSAPI 
SSH_AUTH_KBDINTERACTIVE 

Definition at line 67 of file remmina_file.h.

Function Documentation

◆ remmina_file_copy()

RemminaFile* remmina_file_copy ( const gchar *  filename)

Definition at line 218 of file remmina_file.c.

◆ remmina_file_delete()

void remmina_file_delete ( const gchar *  filename)

Definition at line 912 of file remmina_file.c.

◆ remmina_file_dup()

RemminaFile* remmina_file_dup ( RemminaFile *  remminafile)

Definition at line 866 of file remmina_file.c.

◆ remmina_file_dup_temp_protocol()

RemminaFile* remmina_file_dup_temp_protocol ( RemminaFile *  remminafile,
const gchar *  new_protocol 
)

Definition at line 900 of file remmina_file.c.

◆ remmina_file_format_properties()

gchar* remmina_file_format_properties ( RemminaFile *  remminafile,
const gchar *  setting 
)

Definition at line 562 of file remmina_file.c.

◆ remmina_file_free()

void remmina_file_free ( RemminaFile *  remminafile)

Definition at line 710 of file remmina_file.c.

◆ remmina_file_generate_filename()

void remmina_file_generate_filename ( RemminaFile *  remminafile)

Generate a new Remmina connection profile file name.

File name restrictions:

  • Do not start with space.
  • Do not end with space or dot.
  • No more than 255 chars.
  • Do not contain \0.
  • Avoid % and $.
  • Avoid underscores and spaces for interoperabiility with everything else.
  • Better all lowercase.

Definition at line 115 of file remmina_file.c.

◆ remmina_file_get_datetime()

gchar* remmina_file_get_datetime ( RemminaFile *  remminafile)

Return the string date of the last time a Remmina state file has been modified.

This is used to return the modification date of a file and it’s used to return the modification date and time of a given Remmina file. If it fails it will return "Fri, 16 Oct 2009 07:04:46 GMT", that is just a date to don't return an empty string (challenge: what was happened that day at that time?).

Returns
A date string in the form "%d/%m/%Y %H:%M:%S".
Todo:
This should be moved to remmina_utils.c

Definition at line 1032 of file remmina_file.c.

◆ remmina_file_get_double()

gdouble remmina_file_get_double ( RemminaFile *  remminafile,
const gchar *  setting,
gdouble  default_value 
)

Definition at line 630 of file remmina_file.c.

◆ remmina_file_get_filename()

const gchar* remmina_file_get_filename ( RemminaFile *  remminafile)

Definition at line 211 of file remmina_file.c.

◆ remmina_file_get_icon_name()

const gchar* remmina_file_get_icon_name ( RemminaFile *  remminafile)

Definition at line 886 of file remmina_file.c.

◆ remmina_file_get_int()

gint remmina_file_get_int ( RemminaFile *  remminafile,
const gchar *  setting,
gint  default_value 
)

Definition at line 604 of file remmina_file.c.

◆ remmina_file_get_secret()

gchar* remmina_file_get_secret ( RemminaFile *  remminafile,
const gchar *  setting 
)

Definition at line 552 of file remmina_file.c.

◆ remmina_file_get_state()

const gchar* remmina_file_get_state ( RemminaFile *  remminafile,
const gchar *  setting 
)

Definition at line 926 of file remmina_file.c.

◆ remmina_file_get_state_double()

gdouble remmina_file_get_state_double ( RemminaFile *  remminafile,
const gchar *  setting,
gdouble  default_value 
)

Definition at line 656 of file remmina_file.c.

◆ remmina_file_get_state_int()

gint remmina_file_get_state_int ( RemminaFile *  remminafile,
const gchar *  setting,
gint  default_value 
)

Definition at line 616 of file remmina_file.c.

◆ remmina_file_get_statefile()

const gchar* remmina_file_get_statefile ( RemminaFile *  remminafile)

◆ remmina_file_get_string()

const gchar* remmina_file_get_string ( RemminaFile *  remminafile,
const gchar *  setting 
)

Definition at line 517 of file remmina_file.c.

◆ remmina_file_load()

RemminaFile* remmina_file_load ( const gchar *  filename)

Definition at line 351 of file remmina_file.c.

◆ remmina_file_new()

RemminaFile* remmina_file_new ( void  )

Definition at line 94 of file remmina_file.c.

◆ remmina_file_remove_key()

gboolean remmina_file_remove_key ( RemminaFile *  remminafile,
const gchar *  setting 
)

◆ remmina_file_save()

void remmina_file_save ( RemminaFile *  remminafile)

Definition at line 731 of file remmina_file.c.

◆ remmina_file_set_filename()

void remmina_file_set_filename ( RemminaFile *  remminafile,
const gchar *  filename 
)

Definition at line 183 of file remmina_file.c.

◆ remmina_file_set_int()

void remmina_file_set_int ( RemminaFile *  remminafile,
const gchar *  setting,
gint  value 
)

Definition at line 586 of file remmina_file.c.

◆ remmina_file_set_state()

void remmina_file_set_state ( RemminaFile *  remminafile,
const gchar *  setting,
const gchar *  value 
)

Definition at line 506 of file remmina_file.c.

◆ remmina_file_set_state_int()

void remmina_file_set_state_int ( RemminaFile *  remminafile,
const gchar *  setting,
gint  value 
)

Definition at line 595 of file remmina_file.c.

◆ remmina_file_set_statefile()

void remmina_file_set_statefile ( RemminaFile *  remminafile)

Definition at line 190 of file remmina_file.c.

◆ remmina_file_set_string()

void remmina_file_set_string ( RemminaFile *  remminafile,
const gchar *  setting,
const gchar *  value 
)

Definition at line 470 of file remmina_file.c.

◆ remmina_file_state_last_success()

void remmina_file_state_last_success ( RemminaFile *  remminafile)

Definition at line 949 of file remmina_file.c.

◆ remmina_file_store_secret_plugin_password()

void remmina_file_store_secret_plugin_password ( RemminaFile *  remminafile,
const gchar *  key,
const gchar *  value 
)

Definition at line 847 of file remmina_file.c.

◆ remmina_file_touch()

void remmina_file_touch ( RemminaFile *  remminafile)

Update the atime and mtime of a given filename.

Function used to update the atime and mtime of a given remmina file, partially taken from suckless sbase

See also
https://git.suckless.org/sbase/tree/touch.c
Todo:
This should be moved to remmina_utils.c

Definition at line 1106 of file remmina_file.c.

◆ remmina_file_unsave_passwords()

void remmina_file_unsave_passwords ( RemminaFile *  remminafile)

Definition at line 979 of file remmina_file.c.