Sophie

Sophie

distrib > * > 2009.0 > i586 > by-pkgid > 76909b5763edb96a2bc7bd7fb5b301b8 > files > 24

cuiterm-0.9.9-1mdv2008.1.i586.rpm

<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<HTML><HEAD><TITLE>CuiFilename</TITLE><META NAME="GENERATOR" CONTENT="Modular DocBook HTML Stylesheet Version 1.79"><LINK REL="HOME" TITLE="Cuiterm Reference Manual" HREF="index.html"><LINK REL="UP" TITLE="Cuiterm Documentation 0.5" HREF="c4.html"><LINK REL="PREVIOUS" TITLE="CuiUserMenu" HREF="cuiusermenu.html"><LINK REL="NEXT" TITLE="CuiIcon" HREF="cuiicon.html"><META NAME="GENERATOR" CONTENT="GTK-Doc V1.3 (SGML mode)"><STYLE TYPE="text/css">.synopsis, .classsynopsis {
    background: #eeeeee;
    border: solid 1px #aaaaaa;
    padding: 0.5em;
}
.programlisting {
    background: #eeeeff;
    border: solid 1px #aaaaff;
    padding: 0.5em;
}
.variablelist {
    padding: 4px;
    margin-left: 3em;
}
.navigation {
    background: #ffeeee;
    border: solid 1px #ffaaaa;
    margin-top: 0.5em;
    margin-bottom: 0.5em;
}
.navigation a {
    color: #770000;
}
.navigation a:visited {
    color: #550000;
}
.navigation .title {
    font-size: 200%;
}</STYLE></HEAD><BODY CLASS="REFENTRY" BGCOLOR="#FFFFFF" TEXT="#000000" LINK="#0000FF" VLINK="#840084" ALINK="#0000FF"><TABLE WIDTH="100%" CLASS="navigation" SUMMARY="Navigation header" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD><A ACCESSKEY="p" HREF="cuiusermenu.html"><IMG SRC="left.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Prev"></A></TD><TD><A ACCESSKEY="u" HREF="c4.html"><IMG SRC="up.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Up"></A></TD><TD><A ACCESSKEY="h" HREF="index.html"><IMG SRC="home.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Home"></A></TD><TH WIDTH="100%" align="center">Cuiterm Reference Manual</TH><TD><A ACCESSKEY="n" HREF="cuiicon.html"><IMG SRC="right.png" WIDTH="24" HEIGHT="24" BORDER="0" ALT="Next"></A></TD></TR></TABLE><H1><A NAME="CUIFILENAME"></A>CuiFilename</H1><DIV CLASS="REFNAMEDIV"><A NAME="AEN5780"></A><H2>Name</H2>CuiFilename&nbsp;--&nbsp;</DIV><DIV CLASS="REFSYNOPSISDIV"><A NAME="AEN5783"></A><H2>Synopsis</H2><PRE CLASS="SYNOPSIS">&#13;#include &lt;history.h&gt;


            <A HREF="cuifilename.html#CUIFILENAME-STRUCT">CuiFilename</A>;
<A HREF="cuifilename.html">CuiFilename</A>* <A HREF="cuifilename.html#CUI-FILENAME-NEW">cui_filename_new</A>               (const char *file,
                                             const char *directory);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-FILENAME">cui_filename_get_filename</A>       (<A HREF="cuifilename.html">CuiFilename</A> *file);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-CANONICAL-FILENAME">cui_filename_get_canonical_filename</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *file,
                                             gchar *working_directory);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-CANONICAL-FOR-NEWNAME">cui_filename_get_canonical_for_newname</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *file,
                                             gchar *working_directory,
                                             gchar *newname);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-MODE-STRING">cui_filename_set_mode_string</A>    (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *mode_string);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-MODE-STRING-OWNER">cui_filename_set_mode_string_owner</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-MODE-STRING-GROUP">cui_filename_set_mode_string_group</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-MODE-STRING-OTHERS">cui_filename_set_mode_string_others</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-OWNER">cui_filename_set_owner</A>          (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *owner);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-OWNER">cui_filename_get_owner</A>          (<A HREF="cuifilename.html">CuiFilename</A> *file);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-GROUP">cui_filename_set_group</A>          (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *group);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-GROUP">cui_filename_get_group</A>          (<A HREF="cuifilename.html">CuiFilename</A> *file);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-OWNER-AND-GROUP">cui_filename_set_owner_and_group</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *owner,
                                             const gchar *group);
enum        <A HREF="cuifilename.html#CUIFILETYPE">CuiFileType</A>;
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-COMPRESSED">cui_filename_is_compressed</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename);
<A HREF="cuifilename.html#CUIFILETYPE">CuiFileType</A> <A HREF="cuifilename.html#CUI-FILENAME-GET-FILETYPE">cui_filename_get_filetype</A>       (<A HREF="cuifilename.html">CuiFilename</A> *filename);
const gchar* <A HREF="cuifilename.html#CUI-FILENAME-GET-TYPENAME">cui_filename_get_typename</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-DIR">cui_filename_is_dir</A>             (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-BLOCK-DEVICE">cui_filename_is_block_device</A>    (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-CHARACTER-DEVICE">cui_filename_is_character_device</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-USER-READ">cui_filename_is_user_read</A>       (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-USER-WRITE">cui_filename_is_user_write</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-USER-EXECUTE">cui_filename_is_user_execute</A>    (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-GROUP-READ">cui_filename_is_group_read</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-GROUP-WRITE">cui_filename_is_group_write</A>     (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-GROUP-EXECUTE">cui_filename_is_group_execute</A>   (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-OTHERS-READ">cui_filename_is_others_read</A>     (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-OTHERS-WRITE">cui_filename_is_others_write</A>    (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gboolean    <A HREF="cuifilename.html#CUI-FILENAME-IS-OTHERS-EXECUTE">cui_filename_is_others_execute</A>  (<A HREF="cuifilename.html">CuiFilename</A> *filename);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-FILETYPE-DIR">cui_filename_set_filetype_dir</A>   (<A HREF="cuifilename.html">CuiFilename</A> *filename);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-FILETYPE-REGULAR">cui_filename_set_filetype_regular</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-FILETYPE-LINK">cui_filename_set_filetype_link</A>  (<A HREF="cuifilename.html">CuiFilename</A> *filename);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-EDITOR">cui_filename_get_editor</A>         (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-VIEWER">cui_filename_get_viewer</A>         (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);
gchar*      <A HREF="cuifilename.html#CUI-FILENAME-GET-PROCESSOR">cui_filename_get_processor</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);
CuiFileSizeChange <A HREF="cuifilename.html#CUI-FILENAME-GET-SIZE-CHANGE">cui_filename_get_size_change</A>
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);
GType       <A HREF="cuifilename.html#CUI-FILENAME-GET-TYPE">cui_filename_get_type</A>           (void);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-FILE-SIZE">cui_filename_set_file_size</A>      (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gint64 size);
void        <A HREF="cuifilename.html#CUI-FILENAME-SET-FILETYPE-BLOCK">cui_filename_set_filetype_block</A> (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN5917"></A><H2>Object Hierarchy</H2><PRE CLASS="SYNOPSIS">&#13;  GObject
   +----CuiFilename</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN5921"></A><H2>Properties</H2><PRE CLASS="SYNOPSIS">&#13;  &quot;<A HREF="cuifilename.html#CUIFILENAME--DIRECTORY">directory</A>&quot;            gchararray            : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--FILENAME">filename</A>&quot;             gchararray            : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--GROUP">group</A>&quot;                gchararray            : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--INODE-MODIFIED">inode-modified</A>&quot;       gpointer              : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--LAST-MODIFIED">last-modified</A>&quot;        gpointer              : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--LAST-USED">last-used</A>&quot;            gpointer              : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--MODE-STRING">mode-string</A>&quot;          gchararray            : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--OWNER">owner</A>&quot;                gchararray            : Read / Write
  &quot;<A HREF="cuifilename.html#CUIFILENAME--SIZE">size</A>&quot;                 gint64                : Read / Write</PRE></DIV><DIV CLASS="REFSECT1"><A NAME="AEN5942"></A><H2>Description</H2><P></P></DIV><DIV CLASS="REFSECT1"><A NAME="AEN5945"></A><H2>Details</H2><DIV CLASS="REFSECT2"><A NAME="AEN5947"></A><H3><A NAME="CUIFILENAME-STRUCT"></A>CuiFilename</H3><PRE CLASS="PROGRAMLISTING">typedef struct _CuiFilename CuiFilename;</PRE><P></P><P></P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN5955"></A><H3><A NAME="CUI-FILENAME-NEW"></A>cui_filename_new ()</H3><PRE CLASS="PROGRAMLISTING"><A HREF="cuifilename.html">CuiFilename</A>* cui_filename_new               (const char *file,
                                             const char *directory);</PRE><P>Creates a new <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> which holds infomation about files and
directories.</P><P>The function will unquote the filename with the <SPAN CLASS="TYPE">g_shell_unquote</SPAN> function of
the G library.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN5972"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the basename of the file</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN5977"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">directory</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the path of the directory holds this file</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN5982"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a new <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> object </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN5989"></A><H3><A NAME="CUI-FILENAME-GET-FILENAME"></A>cui_filename_get_filename ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_filename       (<A HREF="cuifilename.html">CuiFilename</A> *file);</PRE><P>Returns the basename of the file. The return value is a newly allocated
memory should be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6000"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6007"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the basename of this file </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6012"></A><H3><A NAME="CUI-FILENAME-GET-CANONICAL-FILENAME"></A>cui_filename_get_canonical_filename ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_canonical_filename
                                            (<A HREF="cuifilename.html">CuiFilename</A> *file,
                                             gchar *working_directory);</PRE><P>Returns the simplest usable name for the file. The return value is newly 
allocated should be freed by the caller.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6024"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6031"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">working_directory</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the current working directory</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6036"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the basename of this file </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6041"></A><H3><A NAME="CUI-FILENAME-GET-CANONICAL-FOR-NEWNAME"></A>cui_filename_get_canonical_for_newname ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_canonical_for_newname
                                            (<A HREF="cuifilename.html">CuiFilename</A> *file,
                                             gchar *working_directory,
                                             gchar *newname);</PRE><P>Returns what will be the canonical name of the given file if we change its
name to the new name. This file is used when generating commands like mv,
shich must be used like this:</P><P>  mv ~/directory/filename ~/directory/newfilename</P><P>The function returns a newly allocated string which should be freed.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6056"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A>:</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6063"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">working_directory</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the current working directory</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6068"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">newname</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the new name of the file </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6073"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the shortest usable new name for the file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6078"></A><H3><A NAME="CUI-FILENAME-SET-MODE-STRING"></A>cui_filename_set_mode_string ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_mode_string    (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *mode_string);</PRE><P>Sets the mode bits stored for this file by disassembling the mode string. The
mode string is looks like this: 'drwxr-----' as the ls program used to print
when the -l option is in use.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6090"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6097"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">mode_string</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the mode string (first column of the output of 'ls -l')</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6102"></A><H3><A NAME="CUI-FILENAME-SET-MODE-STRING-OWNER"></A>cui_filename_set_mode_string_owner ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_mode_string_owner
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);</PRE><P>Sets the mode bits stored for this file by disassembling the mode string.
This function will change the stored mode string if it is already set.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6114"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6121"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">string</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the owner rights in the mode string (eg. "rwx")</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6126"></A><H3><A NAME="CUI-FILENAME-SET-MODE-STRING-GROUP"></A>cui_filename_set_mode_string_group ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_mode_string_group
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);</PRE><P>Sets the mode bits stored for this file by disassembling the mode string.
This function will change the stored mode string if it is already set.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6138"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6145"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">string</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the group rights in the mode string (eg. "rwx")</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6150"></A><H3><A NAME="CUI-FILENAME-SET-MODE-STRING-OTHERS"></A>cui_filename_set_mode_string_others ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_mode_string_others
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *string);</PRE><P>Sets the mode bits stored for this file by disassembling the mode string.
This function will change the stored mode string if it is already set.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6162"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6169"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">string</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the others rights in the mode string (eg. "rwx")</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6174"></A><H3><A NAME="CUI-FILENAME-SET-OWNER"></A>cui_filename_set_owner ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_owner          (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *owner);</PRE><P>Sets the file owner's name for the filename.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6186"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6193"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">owner</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the user name of the owner</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6198"></A><H3><A NAME="CUI-FILENAME-GET-OWNER"></A>cui_filename_get_owner ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_owner          (<A HREF="cuifilename.html">CuiFilename</A> *file);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6209"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6216"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the name of the owner of this file </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6221"></A><H3><A NAME="CUI-FILENAME-SET-GROUP"></A>cui_filename_set_group ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_group          (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *group);</PRE><P>Sets the group owner's name for the filename.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6233"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6240"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">group</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the group name</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6245"></A><H3><A NAME="CUI-FILENAME-GET-GROUP"></A>cui_filename_get_group ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_group          (<A HREF="cuifilename.html">CuiFilename</A> *file);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6256"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">file</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6263"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the name of the group owner of this file </P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6268"></A><H3><A NAME="CUI-FILENAME-SET-OWNER-AND-GROUP"></A>cui_filename_set_owner_and_group ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_owner_and_group
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             const gchar *owner,
                                             const gchar *group);</PRE><P>Sets the name of the file owner and group owner for the filename.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6281"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6288"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">owner</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the user name of the owner</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6293"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">group</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the group name</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6298"></A><H3><A NAME="CUIFILETYPE"></A>enum CuiFileType</H3><PRE CLASS="PROGRAMLISTING">typedef enum {
	FILETYPE_UNKNOWN,
	FILETYPE_FILE,
	FILETYPE_DIRECTORY,
	FILETYPE_BLOCK,
	FILETYPE_CHAR,
	FILETYPE_FIFO,
	FILETYPE_LINK,
	FILETYPE_SOCKET
} CuiFileType;</PRE><P></P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6305"></A><H3><A NAME="CUI-FILENAME-IS-COMPRESSED"></A>cui_filename_is_compressed ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_compressed      (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Returns TRUE if the file is a compressed file. We return FALSE for a tar
archive (if not compressed) since the user may want to compress these files
with some other program.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6316"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6323"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> TRUE if the file is compressed</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6328"></A><H3><A NAME="CUI-FILENAME-GET-FILETYPE"></A>cui_filename_get_filetype ()</H3><PRE CLASS="PROGRAMLISTING"><A HREF="cuifilename.html#CUIFILETYPE">CuiFileType</A> cui_filename_get_filetype       (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Returns the type of the file (such as regular file, directory, block special
file, etc.).</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6339"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <SPAN CLASS="TYPE">Filename</SPAN> object pointer</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6346"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the type of the file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6351"></A><H3><A NAME="CUI-FILENAME-GET-TYPENAME"></A>cui_filename_get_typename ()</H3><PRE CLASS="PROGRAMLISTING">const gchar* cui_filename_get_typename      (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Returns the type of the file as a string (such as "regular file", 
"directory", "block special file", etc.). The string should not modified oor
freed.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6362"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <SPAN CLASS="TYPE">Filename</SPAN> object pointer</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6369"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the type of the file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6374"></A><H3><A NAME="CUI-FILENAME-IS-DIR"></A>cui_filename_is_dir ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_dir             (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6385"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6392"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the given file is a directory type entry.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6397"></A><H3><A NAME="CUI-FILENAME-IS-BLOCK-DEVICE"></A>cui_filename_is_block_device ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_block_device    (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6408"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6415"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the given file is a block device.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6420"></A><H3><A NAME="CUI-FILENAME-IS-CHARACTER-DEVICE"></A>cui_filename_is_character_device ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_character_device
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6431"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6438"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the given file is a character device.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6443"></A><H3><A NAME="CUI-FILENAME-IS-USER-READ"></A>cui_filename_is_user_read ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_user_read       (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6454"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6461"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the user has the right to read the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6466"></A><H3><A NAME="CUI-FILENAME-IS-USER-WRITE"></A>cui_filename_is_user_write ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_user_write      (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6477"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6484"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the user has the right to write the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6489"></A><H3><A NAME="CUI-FILENAME-IS-USER-EXECUTE"></A>cui_filename_is_user_execute ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_user_execute    (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6500"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6507"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the user has the right to execute the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6512"></A><H3><A NAME="CUI-FILENAME-IS-GROUP-READ"></A>cui_filename_is_group_read ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_group_read      (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6523"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6530"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the group has the right to read the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6535"></A><H3><A NAME="CUI-FILENAME-IS-GROUP-WRITE"></A>cui_filename_is_group_write ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_group_write     (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6546"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6553"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the group has the right to write the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6558"></A><H3><A NAME="CUI-FILENAME-IS-GROUP-EXECUTE"></A>cui_filename_is_group_execute ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_group_execute   (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6569"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6576"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the group has the right to execute the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6581"></A><H3><A NAME="CUI-FILENAME-IS-OTHERS-READ"></A>cui_filename_is_others_read ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_others_read     (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6592"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6599"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the others has the right to read the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6604"></A><H3><A NAME="CUI-FILENAME-IS-OTHERS-WRITE"></A>cui_filename_is_others_write ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_others_write    (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6615"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6622"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the others has the right to write the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6627"></A><H3><A NAME="CUI-FILENAME-IS-OTHERS-EXECUTE"></A>cui_filename_is_others_execute ()</H3><PRE CLASS="PROGRAMLISTING">gboolean    cui_filename_is_others_execute  (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6638"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A> </P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6645"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>TRUE if the others has the right to execute the file.&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6650"></A><H3><A NAME="CUI-FILENAME-SET-FILETYPE-DIR"></A>cui_filename_set_filetype_dir ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_filetype_dir   (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Sets the type of the filename to directory type entry.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6661"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6668"></A><H3><A NAME="CUI-FILENAME-SET-FILETYPE-REGULAR"></A>cui_filename_set_filetype_regular ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_filetype_regular
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Sets the type of the filename to regular file.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6679"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6686"></A><H3><A NAME="CUI-FILENAME-SET-FILETYPE-LINK"></A>cui_filename_set_filetype_link ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_filetype_link  (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Sets the type of the filename to soft link.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6697"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6704"></A><H3><A NAME="CUI-FILENAME-GET-EDITOR"></A>cui_filename_get_editor ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_editor         (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);</PRE><P>Returns a command line string which can be used to open an editor (not a
viewer) for the given file. The string is in a newly allocated memory area
which must be freed with the <CODE CLASS="FUNCTION">g_free()</CODE> function.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6718"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6725"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">long_name</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the full name of file used in the command</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6730"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a command which will start up an editor program for this file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6735"></A><H3><A NAME="CUI-FILENAME-GET-VIEWER"></A>cui_filename_get_viewer ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_viewer         (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);</PRE><P>Returns a command line string which can be used to open a viewer (not an
editor) for the given file. The string is in a newly allocated memory area
which must be freed with the <CODE CLASS="FUNCTION">g_free()</CODE> function.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6749"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6756"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">long_name</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the full name of file used in the command</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6761"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a command which will start up a viewer program for this file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6766"></A><H3><A NAME="CUI-FILENAME-GET-PROCESSOR"></A>cui_filename_get_processor ()</H3><PRE CLASS="PROGRAMLISTING">gchar*      cui_filename_get_processor      (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gchar *long_name);</PRE><P>Returns a command line string which can be used to open a processor (not a
viewer) for the given file. The string is in a newly allocated memory area
which must be freed with the <CODE CLASS="FUNCTION">g_free()</CODE> function.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6780"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6787"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">long_name</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> the full name of file used in the command</P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6792"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a command which will start up a processor program for this file</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6797"></A><H3><A NAME="CUI-FILENAME-GET-SIZE-CHANGE"></A>cui_filename_get_size_change ()</H3><PRE CLASS="PROGRAMLISTING">CuiFileSizeChange cui_filename_get_size_change
                                            (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6807"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6812"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6817"></A><H3><A NAME="CUI-FILENAME-GET-TYPE"></A>cui_filename_get_type ()</H3><PRE CLASS="PROGRAMLISTING">GType       cui_filename_get_type           (void);</PRE><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6826"><SPAN STYLE="white-space: nowrap"><SPAN CLASS="emphasis"><I CLASS="EMPHASIS">Returns</I></SPAN>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6831"></A><H3><A NAME="CUI-FILENAME-SET-FILE-SIZE"></A>cui_filename_set_file_size ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_file_size      (<A HREF="cuifilename.html">CuiFilename</A> *filename,
                                             gint64 size);</PRE><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6842"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P></P></TD></TR><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6847"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">size</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P>&#13;</P></TD></TR></TBODY></TABLE></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6852"></A><H3><A NAME="CUI-FILENAME-SET-FILETYPE-BLOCK"></A>cui_filename_set_filetype_block ()</H3><PRE CLASS="PROGRAMLISTING">void        cui_filename_set_filetype_block (<A HREF="cuifilename.html">CuiFilename</A> *filename);</PRE><P>Sets the type of the filename to block device type entry.</P><P></P><P></P><TABLE CLASS="variablelist" BORDER="0" CELLSPACING="0" CELLPADDING="4"><TBODY><TR><TD ALIGN="LEFT" VALIGN="TOP"><A NAME="AEN6863"><SPAN STYLE="white-space: nowrap"><CODE CLASS="PARAMETER">filename</CODE>&nbsp;:</SPAN></TD><TD ALIGN="LEFT" VALIGN="TOP"><P> a <A HREF="cuifilename.html"><SPAN CLASS="TYPE">CuiFilename</SPAN></A></P></TD></TR></TBODY></TABLE></DIV></DIV><DIV CLASS="REFSECT1"><A NAME="AEN6870"></A><H2>Properties</H2><DIV CLASS="REFSECT2"><A NAME="AEN6872"></A><H3><A NAME="CUIFILENAME--DIRECTORY"></A>The &quot;<TT CLASS="LITERAL">directory</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;directory&quot;            gchararray            : Read / Write</PRE><P>The directory in which we found the file.</P><P>Default value: ""</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6880"></A><H3><A NAME="CUIFILENAME--FILENAME"></A>The &quot;<TT CLASS="LITERAL">filename</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;filename&quot;             gchararray            : Read / Write</PRE><P>The basename of the file.</P><P>Default value: ""</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6888"></A><H3><A NAME="CUIFILENAME--GROUP"></A>The &quot;<TT CLASS="LITERAL">group</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;group&quot;                gchararray            : Read / Write</PRE><P>The name of the file group owner.</P><P>Default value: ""</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6896"></A><H3><A NAME="CUIFILENAME--INODE-MODIFIED"></A>The &quot;<TT CLASS="LITERAL">inode-modified</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;inode-modified&quot;       gpointer              : Read / Write</PRE><P>The time the file inode last used.</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6903"></A><H3><A NAME="CUIFILENAME--LAST-MODIFIED"></A>The &quot;<TT CLASS="LITERAL">last-modified</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;last-modified&quot;        gpointer              : Read / Write</PRE><P>The time the file last modified.</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6910"></A><H3><A NAME="CUIFILENAME--LAST-USED"></A>The &quot;<TT CLASS="LITERAL">last-used</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;last-used&quot;            gpointer              : Read / Write</PRE><P>The time the file last used.</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6917"></A><H3><A NAME="CUIFILENAME--MODE-STRING"></A>The &quot;<TT CLASS="LITERAL">mode-string</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;mode-string&quot;          gchararray            : Read / Write</PRE><P>The mode string as the '-l' option of the 'ls' used to write.</P><P>Default value: ""</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6925"></A><H3><A NAME="CUIFILENAME--OWNER"></A>The &quot;<TT CLASS="LITERAL">owner</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;owner&quot;                gchararray            : Read / Write</PRE><P>The user name of the file owner.</P><P>Default value: ""</P></DIV><HR><DIV CLASS="REFSECT2"><A NAME="AEN6933"></A><H3><A NAME="CUIFILENAME--SIZE"></A>The &quot;<TT CLASS="LITERAL">size</TT>&quot; property</H3><PRE CLASS="PROGRAMLISTING">  &quot;size&quot;                 gint64                : Read / Write</PRE><P>File size in bytes.</P><P>Default value: -1</P></DIV></DIV><TABLE CLASS="navigation" WIDTH="100%" SUMMARY="Navigation footer" CELLPADDING="2" CELLSPACING="2"><TR VALIGN="middle"><TD ALIGN="left"><A ACCESSKEY="p" HREF="cuiusermenu.html"><B>&lt;&lt;&lt;&nbsp;CuiUserMenu</B></A></TD><TD ALIGN="right"><A ACCESSKEY="n" HREF="cuiicon.html"><B>CuiIcon&nbsp;&gt;&gt;&gt;</B></A></TD></TR></TABLE></BODY></HTML>