Create a new #AutoarCompressor object. a new #AutoarCompressor object a #GList of source #GFiles to be archived output directory of the new archive, or the file name of the new archive if you set #AutoarCompressor:output-is-dest on the returned object the compression format the compression filter Gets the #AutoarCompressor Error Quark. a #GQuark. Gets the number of files has been read number of files has been read an #AutoarCompressor Gets the size in bytes has been read from the source files and directories. file size in bytes has been read an #AutoarCompressor Gets whether a top level directory will be created in the new archive. whether a top level directory will be created an #AutoarCompressor Gets the number of files will be read when the operation is completed. This value is currently unset, so calling this function is useless. total number of files an #AutoarCompressor Gets the compression filter the compression filter an #AutoarCompressor Gets the compression format the compression format an #AutoarCompressor See autoar_compressor_set_notify_interval(). the minimal interval in microseconds between the emission of the #AutoarCompressor::progress signal. an #AutoarCompressor If #AutoarCompressor:output_is_dest is %FALSE, gets the directory which contains the new archive. Otherwise, gets the the new archive. See autoar_compressor_set_output_is_dest(). a #GFile an #AutoarCompressor See autoar_compressor_set_output_is_dest(). %TRUE if #AutoarCompressor:output is the location of the new archive. an #AutoarCompressor Gets the size in bytes will be read when the operation is completed. This value is currently unset, so calling this function is useless. total file size in bytes an #AutoarCompressor Gets the list of source files. a #GList with the source files an #AutoarCompressor Sets the minimal interval between emission of #AutoarCompressor::progress signal. This prevent too frequent signal emission, which may cause performance impact. If you do not want this feature, you can set the interval to 0, so you will receive every progress update. an #AutoarCompressor the minimal interval in microseconds By default #AutoarCompressor:output-is-dest is set to %FALSE, which means the new archive will be created as a regular file under #AutoarCompressor:output directory. The name of the new archive will be automatically generated and you will be notified via #AutoarCompressor::decide-dest when the name is decided. If you have already decided the location of the new archive, and you do not want #AutoarCompressor to decide it for you, you can set #AutoarCompressor:output-is-dest to %TRUE. #AutoarCompressor will use #AutoarCompressor:output as the location of the new archive, and it will neither check whether the file exists nor create the necessary directories for you. This function should only be called before calling autoar_compressor_start() or autoar_compressor_start_async(). an #AutoarCompressor %TRUE if the location of the new archive has been already decided Sets the archive passphrase. It works only with %ARCHIVE_FORMAT_ZIP. an #AutoarCompressor the archive passphrase Runs the archive creating work. All callbacks will be called in the same thread as the caller of this functions. an #AutoarCompressor object optional #GCancellable object, or %NULL to ignore Asynchronously runs the archive creating work. You should connect to #AutoarCompressor::cancelled, #AutoarCompressor::error, and #AutoarCompressor::completed signal to get notification when the work is terminated. All callbacks will be called in the main thread, so you can safely manipulate GTK+ widgets in the callbacks. an #AutoarCompressor object optional #GCancellable object, or %NULL to ignore This signal is emitted after archive creating job is cancelled by the #GCancellable. This signal is emitted after the archive creating job is successfully completed. This signal is emitted when the location of the new archive is determined. the location of the new archive This signal is emitted when error occurs and all jobs should be terminated. Possible error domains are %AUTOAR_COMPRESSOR_ERROR, %G_IO_ERROR, and %AUTOAR_LIBARCHIVE_ERROR, which represent error occurs in #AutoarCompressor, GIO, and libarchive, respectively. The #GError is owned by #AutoarCompressor and should not be freed. the #GError This signal is used to report progress of creating archives. The value of @completed_size and @completed_files are the same as the #AutoarCompressor:completed_size and #AutoarCompressor:completed_files properties, respectively. bytes has been read from source files and directories number of files and directories has been read Create a new #AutoarExtractor object. a new #AutoarExtractor object a #GFile for the source archive a #GFile for the directory where the files will be extracted Gets the #AutoarExtractor Error Quark. a #GQuark. Gets the number of files has been written to disk. number of files has been written to disk an #AutoarExtractor Gets the size in bytes has been written to disk. size in bytes has been written an #AutoarExtractor Whether the source archive will be deleted after a successful extraction. %TRUE if the source archive will be deleted after a succesful extraction an #AutoarExtractor See autoar_extractor_set_notify_interval(). the minimal interval in microseconds between the emission of the #AutoarExtractor::progress signal. an #AutoarExtractor Gets the #GFile object which represents the output directory of extracted file or directory, or the extracted file or directory itself if you set #AutoarExtractor:output-is-dest on the returned object. a #GFile an #AutoarExtractor See autoar_extractor_set_output_is_dest(). %TRUE if #AutoarExtractor:output-file is the destination for extracted files an #AutoarExtractor Gets the #GFile object which represents the source archive that will be extracted for this object. a #GFile an #AutoarExtractor Gets the total number of files will be written when the operation is completed. total number of extracted files an #AutoarExtractor Gets the size in bytes will be written when the operation is completed. total size of extracted files in bytes an #AutoarExtractor By default #AutoarExtractor:delete-after-extraction is set to %FALSE so the source archive will not be automatically deleted if extraction succeeds. an #AutoarExtractor %TRUE if the source archive should be deleted after a successful extraction Sets the minimal interval between emission of #AutoarExtractor::progress signal. This prevent too frequent signal emission, which may cause performance impact. If you do not want this feature, you can set the interval to 0, so you will receive every progress update. an #AutoarExtractor the minimal interval in microseconds By default #AutoarExtractor:output-is-dest is set to %FALSE, which means only one file or directory will be created in #AutoarExtractor:output-file. The destination is internally determined by analyzing the contents of the archive. If this is not wanted, #AutoarExtractor:output-is-dest can be set to %TRUE, which will make #AutoarExtractor:output-file the destination for extracted files. In any case, the destination will be notified via #AutoarExtractor::decide-destination, when it is possible to set a new destination. #AutoarExtractor will attempt to create the destination regardless to whether its path was internally decided or not. This function should only be called before calling autoar_extractor_start() or autoar_extractor_start_async(). an #AutoarExtractor %TRUE if #AutoarExtractor:output-file is the destination for extracted files Sets a passphrase to use if the file to decompress is passphrase-protected. an #AutoarExtractor object a string with the passphrase to use Runs the archive extracting work. All callbacks will be called in the same thread as the caller of this functions. an #AutoarExtractor object optional #GCancellable object, or %NULL to ignore Asynchronously runs the archive extracting work. You should connect to #AutoarExtractor::cancelled, #AutoarExtractor::error, and #AutoarExtractor::completed signal to get notification when the work is terminated. All callbacks will be called in the main thread, so you can safely manipulate GTK+ widgets in the callbacks. an #AutoarExtractor object optional #GCancellable object, or %NULL to ignore This signal is emitted after archive extracting job is cancelled by the #GCancellable. This signal is emitted after the archive extracting job is successfully completed. the #AutoarConflictAction to be performed by #AutoarExtractor This signal is used to report and offer the possibility to solve name conflicts when extracting files. If it is not handled, the @file will be skipped. a #GFile for the file that caused a conflict a #GFile for the new destination of @file #GFile for location that will overwrite @destination, or %NULL if this is not wanted This signal is emitted when the path of the destination is determined. It is useful for solving name conflicts or for setting a new destination, based on the contents of the archive. a #GFile for the location where files will be extracted the list of #GFile objects to be extracted. All have @destination as their common prefix This signal is emitted when error occurs and all jobs should be terminated. Possible error domains are %AUTOAR_EXTRACTOR_ERROR, %G_IO_ERROR, and %AUTOAR_LIBARCHIVE_ERROR, which represent error occurs in #AutoarExtractor, GIO, and libarchive, respectively. The #GError is owned by #AutoarExtractor and should not be freed. the #GError This signal is used to report progress of extraction. bytes has been written to disk number of files have been written to disk This signal is emitted when the archive extracting job needs a passphrase. This signal is emitted when #AutoarExtractor finish scanning filename entries in the source archive. the number of files will be extracted from the source archive This is a non-negative number which represents filters supported by libarchive. A libarchive filter is a filter which can convert a regular file into a compressed file. %ARCHIVE_FILTER_NONE: No filter %ARCHIVE_FILTER_COMPRESS: UNIX-compressed %ARCHIVE_FILTER_GZIP: Gzip %ARCHIVE_FILTER_BZIP2: Bzip2 %ARCHIVE_FILTER_XZ: XZ %ARCHIVE_FILTER_LZMA: LZMA %ARCHIVE_FILTER_LZIP: Lzip %ARCHIVE_FILTER_LZOP: LZO %ARCHIVE_FILTER_GRZIP: GRZip %ARCHIVE_FILTER_LRZIP: Long Range ZIP (lrzip) This is a non-negative number which represents formats supported by libarchive. A libarchive format is a file format which can store many files as a archive file. %ARCHIVE_FORMAT_ZIP: Zip archive %ARCHIVE_FORMAT_TAR_PAX_RESTRICTED: Tar archive, use ustar format is possible. If there are extended headers which cannot be represented in the ustar format, libarchive will use pax interchage format instead. %ARCHIVE_FORMAT_CPIO_POSIX: CPIO archive, POSIX standard cpio interchage format. %ARCHIVE_FORMAT_7ZIP: 7-zip archive %ARCHIVE_FORMAT_AR_BSD: BSD variant of Unix archive format. This format does not support storing directories. %ARCHIVE_FORMAT_AR_GNU: GNU/SVR4 variant of Unix archive format. This format does not support storing directories. %ARCHIVE_FORMAT_CPIO_SVR4_NOCRC: CPIO archive, SVR4 non-CRC variant %ARCHIVE_FORMAT_TAR_GNUTAR: Tar archive, support most popular GNU extensions. %ARCHIVE_FORMAT_ISO9660: Raw CD image %ARCHIVE_FORMAT_TAR_PAX_INTERCHANGE: Tar archive, use pax interchage format %ARCHIVE_FORMAT_TAR_USTAR: Tar archive, use old ustar format %ARCHIVE_FORMAT_XAR: Xar archive The #AutoarCompressor object is used to automatically compress files and directories into an archive. The new archive can contain a top-level directory. Applying multiple filters is currently not supported because most applications do not need this function. GIO is used for both read and write operations. A few POSIX functions are also used to get more information from files if GIO does not provide relevant functions. When #AutoarCompressor stop all work, it will emit one of the three signals: #AutoarCompressor::cancelled, #AutoarCompressor::error, and #AutoarCompressor::completed. After one of these signals is received, the #AutoarCompressor object should be destroyed because it cannot be used to start another archive operation. An #AutoarCompressor object can only be used once and create one archive. The #AutoarExtractor object is used to automatically extract files and directories from an archive. By default, it will only create one file or directory in the output directory. This is done to avoid clutter on the user's output directory. If the archive contains only one file with the same name as the source archive without the extension, the file will be extracted to the output directory. Otherwise the files will be extracted in a directory having the same name as the source archive, except the extension. It is also possible to just extract all files to the output directory (note that this will not perform any checks) by using autoar_extractor_set_output_is_dest(). #AutoarExtractor will not attempt to solve any name conflicts. If the destination directory already exists, it will proceed normally. If the destination directory cannot be created, it will fail with an error. It is possible however to change the destination, when #AutoarExtractor::decide-destination is emitted. The signal provides the decided destination and the list of files to be extracted. The signal also allows a new output destination to be used instead of the one provided by #AutoarExtractor. This is convenient for solving name conflicts and implementing specific logic based on the contents of the archive. When #AutoarExtractor stops all work, it will emit one of the three signals: #AutoarExtractor::cancelled, #AutoarExtractor::error, and #AutoarExtractor::completed. After one of these signals is received, the #AutoarExtractor object should be destroyed because it cannot be used to start another archive operation. An #AutoarExtractor object can only be used once and extract one archive. autoar-format-filter is a collection of functions providing information of archive formats and filters. Public utility functions and data types used by gnome-autoar; Checks whether a mime type is supported by autoar. This function does no blocking IO. %TRUE if the mime type is supported a string representing the mime type Gets description of the filter from the internal static data. description about the filter an #AutoarFilter Gets description of the filter from libarchive. This function creates and destroys an archive object in order to get the description string. description about the filter. Free the returned string with g_free(). an #AutoarFilter Gets the file name extension of the filter from the internal static data. a file name extension an #AutoarFilter Gets the filter code used by libarchive. You can use the return value as the argument for archive_write_add_filter(). an integer an #AutoarFilter Gets the function used to add filter on the object returned by archive_read_new(). function pointer to the setter function provided by libarchive an #AutoarFilter Gets the function used to add filter on the object returned by archive_write_new(). function pointer to the setter function provided by libarchive an #AutoarFilter Gets the MIME type of the filter from the internal static data. an MIME type an #AutoarFilter Checks whether an #AutoarFilter is valid. %TRUE if the value of @filter is valid an #AutoarFilter Gets the maximal allowed values of #AutoarFilter maximal allowed values of #AutoarFilter Gets the description for an archive @format compressed by @filter using #GContentType and autoar_format_filter_get_mime_type(). description about the archive. Free the returned string with g_free(). an #AutoarFormat an #AutoarFilter Gets the file name extension for an archive @format compressed by @filter. The first character of the returned string is always '.' a file name extension. Free the returned string with g_free(). an #AutoarFormat an #AutoarFilter Gets the MIME type for an archive @format compressed by @filter. This function always succeed, but it is not guaranteed that the returned MIME type exists and can be recognized by applications. Some combination of format and filter seldom exists in application, so this function can only generate the string based on some non-standard rules. an MIME type. Free the returned string with g_free(). an #AutoarFormat an #AutoarFilter Gets description of the format from the internal static data. description about the format an #AutoarFormat Gets description of the format from libarchive. This function creates and destroys an archive object in order to get the description string. description about the format. Free the returned string with g_free(). an #AutoarFormat Gets the file name extension of the format from the internal static data. a file name extension an #AutoarFormat Gets the format code used by libarchive. You can use the return value as the argument for archive_read_support_format_by_code() and archive_write_set_format(). However, some format cannot be set using these two functions because of problems inside libarchive. Use autoar_format_get_libarchive_read() and autoar_format_get_libarchive_write() to get the function pointer is the more reliable way to set format on the archive object. an integer an #AutoarFormat Gets the function used to set format on the object returned by archive_read_new(). function pointer to the setter function provided by libarchive an #AutoarFormat Gets the function used to set format on the object returned by archive_write_new(). function pointer to the setter function provided by libarchive an #AutoarFormat Gets the MIME type of the format from the internal static data. an MIME type an #AutoarFormat Checks whether an #AutoarFormat is valid. %TRUE if the value of @format is valid an #AutoarFormat Gets the maximal allowed values of #AutoarFormat maximal allowed values of #AutoarFormat Gets the libarchive Error Quark. a #GQuark. This function will query the file's mime type and then call autoar_check_mime_type_supported(), so it does blocking IO. %TRUE if the mime type of the #GFile is supported a #GFile to check if its mime type is supported