mate-vfs-standard-callbacks

mate-vfs-standard-callbacks — standard callbacks for use by mate-vfs module writers

Synopsis

#define             MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION
                    MateVFSModuleCallbackFillAuthenticationIn;
                    MateVFSModuleCallbackFillAuthenticationOut;
#define             MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION
enum                MateVFSModuleCallbackFullAuthenticationFlags;
                    MateVFSModuleCallbackFullAuthenticationIn;
                    MateVFSModuleCallbackFullAuthenticationOut;
enum                MateVFSModuleCallbackFullAuthenticationOutFlags;
#define             MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION
                    MateVFSModuleCallbackSaveAuthenticationIn;
                    MateVFSModuleCallbackSaveAuthenticationOut;
#define             MATE_VFS_MODULE_CALLBACK_QUESTION
                    MateVFSModuleCallbackQuestionIn;
                    MateVFSModuleCallbackQuestionOut;
#define             MATE_VFS_MODULE_CALLBACK_STATUS_MESSAGE
                    MateVFSModuleCallbackStatusMessageIn;
                    MateVFSModuleCallbackStatusMessageOut;
#define             MATE_VFS_MODULE_CALLBACK_HTTP_SEND_ADDITIONAL_HEADERS
                    MateVFSModuleCallbackAdditionalHeadersIn;
                    MateVFSModuleCallbackAdditionalHeadersOut;
#define             MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS
                    MateVFSModuleCallbackReceivedHeadersIn;
                    MateVFSModuleCallbackReceivedHeadersOut;
#define             MATE_VFS_MODULE_CALLBACK_AUTHENTICATION
#define             MATE_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION
enum                MateVFSModuleCallbackAuthenticationAuthType;
                    MateVFSModuleCallbackAuthenticationIn;
                    MateVFSModuleCallbackAuthenticationOut;

Description

Details

MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION

#define MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION "fill-authentication"

A module callback name used together with mate_vfs_module_callback_invoke() to ask the keyring manager for login data. It is expected to return stored or cached login data, but may not query the user.

The login data consists of a username, a password and a domain, and is used to access a resource. If the data is not suitable for accessing the resource, the MateVFSModule typically issues a MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION module callback to query the user right after the authentication failed.

in arg :

A MateVFSModuleCallbackFillAuthenticationIn * passed to the application, specifying the authentication request. The application will usually proxy this request to the keyring manager of the desktop environment, but it can also handle the request itself.

out arg :

A MateVFSModuleCallbackFillAuthenticationOut * passing the cached keyring data (i.e. username/password etc.) back to the module. Usually, this is data that was stored using MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION, and is either stored permanently on disk or cached.


MateVFSModuleCallbackFillAuthenticationIn

typedef struct {
	char *uri;
	char *protocol;
	char *server;
	char *object;
	int port;
	char *authtype;
	char *username;
	char *domain;
} MateVFSModuleCallbackFillAuthenticationIn;

A pointer to a MateVFSModuleCallbackFillAuthenticationIn structure is passed to the MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION callback, and informs the application about the authentication parameters that should be requested from the user.

The MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION application callback will then set the members of a pointer to a MateVFSModuleCallbackFillAuthenticationOut structure according to the stored or cached data.

char *uri;

The textual URI of the resource that requires authentication.

char *protocol;

One of the protocols supported by the invoking module. Typically matches uri's protocol.

char *server;

The server that contains the resource that requires authentication. Typically matches uri's hostname.

char *object;

The type of the resource that requires authentication.

int port;

The port that was used to connect to server. 0 means unset.

char *authtype;

The type of authentication that was requested. For the HTTP method, this may be "basic" or "proxy". For the SFTP method, this may be "publickey" or "password".

char *username;

The username that was used to connect to server.

char *domain;

The domain that server belongs to (only used by the SMB method).

MateVFSModuleCallbackFillAuthenticationOut

typedef struct {
	gboolean valid;
	char *username;
	char *domain;
	char *password;
} MateVFSModuleCallbackFillAuthenticationOut;

A pointer to a MateVFSModuleCallbackFillAuthenticationOut structure is passed to the MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION callback, and informs the module about the authentication parameters that were found in the cache or permanently stored.

The login data returned by MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION was usually previously stored using #MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION.

gboolean valid;

Whether stored or cached login data was found for the resource referenced by the MateVFSModuleCallbackFillAuthenticationIn structure.

char *username;

The cached username that should be used to access the resource. This will be freed by the module when it isn't needed any longer. May only be set if valid is TRUE.

char *domain;

The cached domain that should be used to access the resource. This will be freed by the module when it isn't needed any longer. May only be set if valid is TRUE.

char *password;

The cached password that should be used to access the resource. This will be freed by the module when it isn't needed any longer. May only be set if valid is TRUE.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION

#define MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION "full-authentication"

A module callback name used together with mate_vfs_module_callback_invoke() to ask the user for login data. This includes username and password, but also special login choices like anonymous login.

in arg :

A MateVFSModuleCallbackFullAuthenticationIn * passed to the application, specifying the authentication request.

out arg :

A MateVFSModuleCallbackFullAuthenticationOut * passing the user's provided authentication data (i.e. his username/password etc.) back to the module.


enum MateVFSModuleCallbackFullAuthenticationFlags

typedef enum {
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_PREVIOUS_ATTEMPT_FAILED = 1<<0,
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_PASSWORD = 1<<1,
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_USERNAME = 1<<2,
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_DOMAIN = 1<<3,
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_SAVING_SUPPORTED = 1<<4,
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_ANON_SUPPORTED = 1<<5
} MateVFSModuleCallbackFullAuthenticationFlags;

These flags will be passed to the MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback, as part of the MateVFSModuleCallbackFullAuthenticationIn structure. The output data will be stored in a MateVFSModuleCallbackFullAuthenticationOut structure.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_PREVIOUS_ATTEMPT_FAILED

This is not the first login attempt, i.e. this callback was already invoked but the provided login data was not suitable for a successful login.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_PASSWORD

The application should ask the user for a password and set the password field of MateVFSModuleCallbackFullAuthenticationOut.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_USERNAME

The application should ask the user for a username and set the username field of MateVFSModuleCallbackFullAuthenticationOut.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_DOMAIN

The application should ask the user for a domain and set the domain field of MateVFSModuleCallbackFullAuthenticationOut.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_SAVING_SUPPORTED

The application may ask the user whether he wants to save the password. If this flag is not present, or the user does not want to save the password, the application must set the save_password field of MateVFSModuleCallbackFullAuthenticationOut to FALSE and its keyring field to NULL. If the save_password field is TRUE, the module invoking the MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback is expected to invoke the MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION callback if the login attempt was successful with the username, password, domain and keyring fields of MateVFSModuleCallbackFullAuthenticationOut.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_ANON_SUPPORTED

The application should offer the user a choice to login anonymously (used for example by the FTP module). If the user requests anonymous login, MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_OUT_ANON_SELECTED must be set in the out_flags field of MateVFSModuleCallbackFullAuthenticationOut.

MateVFSModuleCallbackFullAuthenticationIn

typedef struct {
	MateVFSModuleCallbackFullAuthenticationFlags flags;

	char *uri;
	char *protocol;
	char *server;
	char *object;
	int port;
	char *authtype;
	char *username;
	char *domain;

	/* for pre-filling the dialog */
	char *default_user;
	char *default_domain;
} MateVFSModuleCallbackFullAuthenticationIn;

A pointer to a MateVFSModuleCallbackFullAuthenticationIn structure is passed to the MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback, and informs the application about the authentication parameters that should be requested from the user.

The MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION application callback will then set the members of a pointer to a MateVFSModuleCallbackFullAuthenticationOut structure according to the user input.

MateVFSModuleCallbackFullAuthenticationFlags flags;

MateVFSModuleCallbackFullAuthenticationFlags influencing the user query.

char *uri;

The textual URI of the resource that requires authentication.

char *protocol;

One of the protocols supported by the invoking module. Typically matches uri's protocol.

char *server;

The server that contains the resource that requires authentication. Typically matches uri's hostname.

char *object;

The type of the resource that requires authentication.

int port;

The port that was used to connect to server. 0 means unset.

char *authtype;

The type of authentication that was requested. For the HTTP method, this may be "basic" or "proxy". For the SFTP method, this may be "publickey" or "password".

char *username;

The username that was used to connect to server. This variable should just be used for display purposes, i.e. like You were trying to access foobar.com where foo is the username and bar.com is the server. Do not make the contents of the MateVFSModuleCallbackFullAuthenticationOut output variables depend on the value of this variable. If you want to handle absence of user input, pass back default_user instead.

char *domain;

The domain that server belongs to (only used by the SMB method). This variable should just be used for display purposes where foo is the username and bar.com is the server. Do not make the contents of the MateVFSModuleCallbackFullAuthenticationOut output variables depend on the value of this variable. If you want to handle absence of user input, pass back default_domain instead.

char *default_user;

The username that should be provided to the user by default. Typically matches username.

char *default_domain;

The domain that should be provided to the user by default. Typically matches domain.

MateVFSModuleCallbackFullAuthenticationOut

typedef struct {
	gboolean abort_auth;

	char *username;
	char *domain;
	char *password;

	gboolean save_password;
	char *keyring;

	gsize out_flags;
} MateVFSModuleCallbackFullAuthenticationOut;

A pointer to a MateVFSModuleCallbackFullAuthenticationOut structure is passed to the MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback, and informs the module about the authentication parameters that the user provided by setting the respective fields according to the user input and the passed-in MateVFSModuleCallbackFullAuthenticationIn pointer.

gboolean abort_auth;

Whether the user somehow cancelled the login process. The application is expected to offer the user a cancellation point during the authentication query. In a graphical user interface, this is typically achieved by providing a "Cancel" button.

char *username;

The user-provided username that should be used to access the resource referenced by MateVFSModuleCallbackFullAuthenticationIn. This will be freed by the module when it isn't needed any longer. Must not be set if the MateVFSModuleCallbackFullAuthenticationFlags don't contain MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_USERNAME.

char *domain;

The user-provided domain that should be used to access the resource referenced by MateVFSModuleCallbackFullAuthenticationIn. This will be freed by the module when it isn't needed any longer. Must not be set if the MateVFSModuleCallbackFullAuthenticationFlags don't contain MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_DOMAIN.

char *password;

The user-provided password that should be used to access the resource referenced by MateVFSModuleCallbackFullAuthenticationIn. This will be freed by the module when it isn't needed any longer. Must not be set if the MateVFSModuleCallbackFullAuthenticationFlags don't contain MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_NEED_PASSOWRD.

gboolean save_password;

Flags whether the user requested to save the provided login data. Must be FALSE if the MateVFSModuleCallbackFullAuthenticationFlags don't contain MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_SAVING_SUPPORTED.

char *keyring;

Flags which keyring should be used to save the password. This will later be passed to the MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION callback if the login attempt was successful with the specified username, password and domain. This will NOT be freed by the module, so the application typically provides a NULL pointer or a pointer to a static string.

gsize out_flags;

MateVFSModuleCallbackFullAuthenticationOutFlags signalling a special request, for instance anonymous access to an FTP server.

enum MateVFSModuleCallbackFullAuthenticationOutFlags

typedef enum {
	MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_OUT_ANON_SELECTED = 1<<0
} MateVFSModuleCallbackFullAuthenticationOutFlags;

These flags will be passed from a MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback back to the module, as part of the MateVFSModuleCallbackFullAuthenticationOut structure.

MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_OUT_ANON_SELECTED

Anonymous login requested. May only be set if the MateVFSModuleCallbackFullAuthenticationIn's MateVFSModuleCallbackFullAuthenticationFlags contain MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION_ANON_SUPPORTED.

MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION

#define MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION "save-authentication"

A module callback name used together with mate_vfs_module_callback_invoke() to request permanent or temporary storage of login data. The storage is typically done using a keyring manager.

Called after a successfull authentication, to allow the client to e.g. store the password for future use. It may be queried again within the current session (temporary storage) or in future sessions (permanent storage) using MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION.

This is typically called after the user provided login data with MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION.

in arg :

A MateVFSModuleCallbackSaveAuthenticationIn * specifying the login data.

out arg :

A MateVFSModuleCallbackSaveAuthenticationOut * (unused).


MateVFSModuleCallbackSaveAuthenticationIn

typedef struct {
	char *keyring;

	char *uri;
	char *protocol;
	char *server;
	char *object;
	int port;
	char *authtype;
	char *username;
	char *domain;
	char *password;
} MateVFSModuleCallbackSaveAuthenticationIn;

A MateVFSModuleCallbackSaveAuthenticatioIn pointer is passed to a MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION application callback, and specifies the login data that should be stored permanently on disk or temporarily cached.

This data may be queried in future sessions (permanent storage) or within the current session (temporary storage) using MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION.

char *keyring;

Keyring provided by MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION callback.

char *uri;

The textual URI of the resource that is accessed.

char *protocol;

One of the protocols supported by the invoking module. Typically matches uri's protocol.

char *server;

The server that contains the resource that is accessed. Typically matches uri's hostname.

char *object;

The type of the resource that is accessed.

int port;

The port that was used to connect to server. 0 means unset.

char *authtype;

The type of authentication that was requested. For the HTTP method, this may be "basic" or "proxy". For the SFTP method, this may be "publickey" or "password".

char *username;

The username that was used to connect to server.

char *domain;

The domain that server belongs to (only used by the SMB method).

char *password;

The password that was used to connect to server.

MateVFSModuleCallbackSaveAuthenticationOut

typedef struct {
} MateVFSModuleCallbackSaveAuthenticationOut;

A MateVFSModuleCallbackSaveAuthenticationOut pointer is passed to a MATE_VFS_MODULE_CALLBACK_SAVE_AUTHENTICATION application callback, and is reserved for future use. Applications are not expected to modify this data, because its interpretation might change in the future.


MATE_VFS_MODULE_CALLBACK_QUESTION

#define MATE_VFS_MODULE_CALLBACK_QUESTION "ask-question"

A module callback name used together with mate_vfs_module_callback_invoke() to ask the user a question.

Called when access to a URI requires the user to make a choice.

in arg :

A MateVFSModuleCallbackFullAuthenticationIn * passed to the application,

out arg :

specifying the proxy authentication request. A MateVFSModuleCallbackFullAuthenticationOut * passing the user's provided proxy authentication data (i.e. his username/password) back to the module.


MateVFSModuleCallbackQuestionIn

typedef struct {
	char *primary_message;
	char *secondary_message;
	char **choices;
} MateVFSModuleCallbackQuestionIn;

A MateVFSModuleCallbackQuestionIn pointer is passed to a MATE_VFS_MODULE_CALLBACK_QUESTION application callback. Applications are expected to request a decision from the user, and store the answer in a MateVFSModuleCallbackQuestionOut structure.

char *primary_message;

A short message explaining the question to the user, or NULL if there is no message.

char *secondary_message;

The long version of the message, containing more details, or NULL if there is no message.

char **choices;

NULL-terminated string list of choices the user has to choose from. The first item in the list should be affermative, and will be put on the right in a GUI dialog.

MateVFSModuleCallbackQuestionOut

typedef struct {
	int answer;
} MateVFSModuleCallbackQuestionOut;

A MateVFSModuleCallbackQuestionOut pointer is passed to a MATE_VFS_MODULE_CALLBACK_QUESTION application callback, and is used by applications to store the user's decision.

int answer;

The index of the answer the user picked. Matches the base pointer address of the user's choice in MateVFSModuleCallbackQuestionIn, i.e. its index in choices, where the first choice has index 0.

MATE_VFS_MODULE_CALLBACK_STATUS_MESSAGE

#define MATE_VFS_MODULE_CALLBACK_STATUS_MESSAGE "status-message"

A module callback name used together with mate_vfs_module_callback_invoke() to inform the user about an ongoing operation.

Called when a MateVFSModule has a status message to return to the user.

in arg :

A MateVFSModuleCallbackStatusMessageIn * containing the message to present to the user.

out arg :

A MateVFSModuleCallbackStatusMessageOut * (not used).


MateVFSModuleCallbackStatusMessageIn

typedef struct {
	char *uri;
	char *message;
	int percentage;
} MateVFSModuleCallbackStatusMessageIn;

A MateVFSModuleCallbackStatusMessageIn pointer is passed to a MATE_VFS_MODULE_CALLBACK_STATUS_MESSAGE application callback, to inform it about the progress and/or status of an ongoing operation.

char *uri;

The textual URI the status message refers to.

char *message;

The message the application should display to the user, indicating the current state, or it is NULL.

int percentage;

The percentage indicating the completeness of a currently pending operation on uri (1-100), or -1 if there is no progress percentage to report.

MateVFSModuleCallbackStatusMessageOut

typedef struct {
	/* empty structs not allowed */
	int dummy;
} MateVFSModuleCallbackStatusMessageOut;

A MateVFSModuleCallbackStatusMessageOut pointer is passed to a MATE_VFS_MODULE_CALLBACK_STATUS_MESSAGE application callback, and is reserved for future use. Applications are not expected to modify this data, because its interpretation might change in the future.

int dummy;

unused.

MATE_VFS_MODULE_CALLBACK_HTTP_SEND_ADDITIONAL_HEADERS

#define MATE_VFS_MODULE_CALLBACK_HTTP_SEND_ADDITIONAL_HEADERS "http:send-additional-headers"

A module callback name used together with mate_vfs_module_callback_invoke() to request additional HTTP headers.

Called before sending headers to an HTTP server. Client applications can add additional headers.

in arg :

A MateVFSModuleCallbackAdditionalHeadersIn * identifying the resource.

out arg :

A MateVFSModuleCallbackAdditionalHeadersOut * allowing to add headers to the request.


MateVFSModuleCallbackAdditionalHeadersIn

typedef struct {
	MateVFSURI *uri;
} MateVFSModuleCallbackAdditionalHeadersIn;

A MateVFSModuleCallbackAdditionalHeadersIn pointer is passed to a MATE_VFS_MODULE_CALLBACK_HTTP_SEND_ADDITIONAL_HEADERS application callback, to inform it about a pending HTTP request and allow it to add additional headers.

MateVFSURI *uri;

A MateVFSURI identifying the resource of the currently pending request.

MateVFSModuleCallbackAdditionalHeadersOut

typedef struct {
	GList *headers;
} MateVFSModuleCallbackAdditionalHeadersOut;

A MateVFSModuleCallbackAdditionalHeadersOut pointer is passed to a MATE_VFS_MODULE_CALLBACK_HTTP_SEND_ADDITIONAL_HEADERS application callback, to store the headers the application wants to add to a pending HTTP request.

GList *headers;

A GList of strings, each of them is an additional header that is added to the HTTP request. headers and all its strings will be freed by the module when they aren't needed any longer.

MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS

#define MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS "http:received-headers"

A module callback name used together with mate_vfs_module_callback_invoke() to inform an application about the delivery of a HTTP request.

MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS is called after receiving HTTP headers from a server that belonged to a HTTP request that was issued by the application and allows the application to analyze the returned headers.


MateVFSModuleCallbackReceivedHeadersIn

typedef struct {
	MateVFSURI *uri;
	GList *headers;
} MateVFSModuleCallbackReceivedHeadersIn;

A MateVFSModuleCallbackReceivedHeadersIn pointer is passed to a MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS application callback, to inform it about a delivered HTTP request and allow it to analyze the returned headers.

MateVFSURI *uri;

A MateVFSURI identifying the resource of the currently delivered request.

GList *headers;

A GList of strings, each of them is a header that was received when delivering the HTTP request. headers and all its strings will be freed by the module when they aren't needed any longer.

MateVFSModuleCallbackReceivedHeadersOut

typedef struct {
	int dummy;
} MateVFSModuleCallbackReceivedHeadersOut;

A MateVFSModuleCallbackReceivedHeadersOut pointer is passed to a MATE_VFS_MODULE_CALLBACK_HTTP_RECEIVED_HEADERS application callback, and is reserved for future use. Applications are not expected to modify this data, because its interpretation might change in the future.

int dummy;

unused.

MATE_VFS_MODULE_CALLBACK_AUTHENTICATION

#define MATE_VFS_MODULE_CALLBACK_AUTHENTICATION "simple-authentication"

Warning

MATE_VFS_MODULE_CALLBACK_AUTHENTICATION is deprecated and should not be used in newly-written code. Modules should use MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION and MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION.

A module callback name formerly used together with mate_vfs_module_callback_invoke().

Formerly called when access to a URI requires a username/password.


MATE_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION

#define MATE_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION "http:proxy-authentication"

Warning

MATE_VFS_MODULE_CALLBACK_HTTP_PROXY_AUTHENTICATION is deprecated and should not be used in newly-written code. Proxy authentication now works desktop-wide through MateConf.

A module callback name formerly used together with mate_vfs_module_callback_invoke() to ask the user for HTTP proxy login data. It works exactly like MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION, and used to be kept separate to allow applications to distinguish proxy authentication from actual server authentication, so that the wording of the interface could be adapted.

Formerly called when access to an HTTP proxy required a username/password.


enum MateVFSModuleCallbackAuthenticationAuthType

typedef enum {
	AuthTypeBasic,
	AuthTypeDigest
} MateVFSModuleCallbackAuthenticationAuthType;

Warning

MateVFSModuleCallbackAuthenticationAuthType is deprecated and should not be used in newly-written code. Modules should use MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION and MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION.

This defines the possible values of the MateVFSModuleCallbackAuthenticationIn's auth_type field.

AuthTypeBasic

transmit password unencrypted.

AuthTypeDigest

transmit digest instead of plaintext credentials.

MateVFSModuleCallbackAuthenticationIn

typedef struct {
	char *uri;
	char *realm;
	gboolean previous_attempt_failed;
	MateVFSModuleCallbackAuthenticationAuthType auth_type;
} MateVFSModuleCallbackAuthenticationIn;

Warning

MateVFSModuleCallbackAuthenticationIn is deprecated and should not be used in newly-written code. Modules should use MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION and MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION.

A pointer to a MateVFSModuleCallbackAuthenticationIn structure that used to be passed to the MATE_VFS_MODULE_CALLBACK_AUTHENTICATION callback, and informed the application about the authentication parameters that should be requested.

char *uri;

The textual URI of the resource that requires authentication.

char *realm;

"auth" for HTTP, NULL for others.

gboolean previous_attempt_failed;

TRUE if there already was login data specified for this request, but the login failed. FALSE if no previous login attempt has been made right before this one.

MateVFSModuleCallbackAuthenticationAuthType auth_type;

Whether the login data will be transmitted in plaintext or encrypted.

MateVFSModuleCallbackAuthenticationOut

typedef struct {
	char *username;
	char *password;
} MateVFSModuleCallbackAuthenticationOut;

Warning

MateVFSModuleCallbackAuthenticationOut is deprecated and should not be used in newly-written code. Modules should use MATE_VFS_MODULE_CALLBACK_FILL_AUTHENTICATION and MATE_VFS_MODULE_CALLBACK_FULL_AUTHENTICATION.

A pointer to a MateVFSModuleCallbackAuthenticationOut structure that used to be passed to the MATE_VFS_MODULE_CALLBACK_AUTHENTICATION callback, and was used to pass the login data back to the module.

char *username;

The username that should be used to access the resource referenced by MateVFSModuleCallbackFullAuthenticationIn, or NULL if no data was provided. This will be freed by the module when it isn't needed any longer.

char *password;

The password that should be used to access the resource referenced by MateVFSModuleCallbackFullAuthenticationIn. This will be freed by the module when it isn't needed any longer.