Unicode C

Get the Format of an FTP Entry's Permissions String

Demonstrates the Chilkat Ftp2.GetPermType method, which returns the format identifier for the permissions string of a cached listing entry. The only argument is a zero-based index. The value is empty when no permissions are available.

Background: Because different servers express permissions differently, GetPermissions alone is ambiguous — the same characters could mean different things. GetPermType names the format so your code knows which parser to apply, or whether to treat the string as an opaque label. It is the companion you check first when permissions actually need to be interpreted rather than merely displayed.

Chilkat Unicode C Downloads

Download Chilkat for Unicode C

Unicode C

#include <C_CkFtp2W.h>

void ChilkatSample(void)
    {
    BOOL success;
    HCkFtp2W ftp;
    int n;
    int i;
    const wchar_t *name;
    const wchar_t *permType;
    const wchar_t *perms;

    success = FALSE;

    //  Demonstrates the Ftp2.GetPermType method, which returns the format identifier for the
    //  permissions string of a cached listing entry.  The only argument is a zero-based index.

    ftp = CkFtp2W_Create();

    CkFtp2W_putHostname(ftp,L"ftp.example.com");
    CkFtp2W_putUsername(ftp,L"myFtpLogin");

    //  Normally you would not hard-code the password in source.  You should instead obtain it
    //  from an interactive prompt, environment variable, or a secrets vault.
    CkFtp2W_putPassword(ftp,L"myPassword");

    success = CkFtp2W_Connect(ftp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    success = CkFtp2W_ChangeRemoteDir(ftp,L"public_html");
    if (success == FALSE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    //  GetDirCount retrieves the directory listing on the first call and returns the number of
    //  entries.  A negative return indicates failure.
    n = CkFtp2W_GetDirCount(ftp);
    if (n < 0) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }

    for (i = 0; i <= n - 1; i++) {
        name = CkFtp2W_getFilename(ftp,i);

        //  GetPermType tells you how to interpret the GetPermissions string (for example a Unix-style
        //  "drwxr-xr-x" versus another format).  It is empty when no permissions are available.
        permType = CkFtp2W_getPermType(ftp,i);
        perms = CkFtp2W_getPermissions(ftp,i);
        wprintf(L"%s  perms=%s (%s)\n",name,perms,permType);
    }

    success = CkFtp2W_Disconnect(ftp);
    if (success == FALSE) {
        wprintf(L"%s\n",CkFtp2W_lastErrorText(ftp));
        CkFtp2W_Dispose(ftp);
        return;
    }



    CkFtp2W_Dispose(ftp);

    }