njb_datafile_struct

Langue: en

Version: 340817 (ubuntu - 24/10/10)

Section: 3 (Bibliothèques de fonctions)

NAME

njb_datafile_struct -

SYNOPSIS


#include <libnjb.h>

Data Fields


char * filename

char * folder

u_int32_t timestamp

u_int32_t flags

u_int32_t dfid

u_int64_t filesize

njb_datafile_t * nextdf

Detailed Description

This is the struct storing the metadata of a regular file or folder.

Examples:

files.c, and getfile.c.

Field Documentation

u_int32_t njb_datafile_struct::dfidThe 32-bit unsigned file ID.

Examples: files.c, and getfile.c.

char* njb_datafile_struct::filenameThe name of this file. The name '.' means that this is an empty folder name marker.

Examples: files.c.

Referenced by datafile_pack(), datafile_pack3(), datafile_set_name(), datafile_unpack(), and NJB_Datafile_Destroy().

u_int64_t njb_datafile_struct::filesizeThe file size as a 64-bit unsigned integer. The files on series 3 devices only have 32-bit signed length (and can only be 2GB in size) but the NJB1 supports 64-bit length.

Examples: files.c, and getfile.c.

Referenced by datafile_pack(), datafile_pack3(), datafile_set_size(), datafile_size(), and datafile_unpack().

u_int32_t njb_datafile_struct::flagsThese are ordinary windows file flags:

 
  bit (from MSB)   meaning
  -----------------------------
  31               Normal file (0x80000000U)
  29               This file should be archived (0x20000000U) 
  28               Directory (0x10000000U)
  26               System file (0x04000000U)
  25               Hidden file (0x02000000U)
  24               Read only file (0x01000000U)
  22               Encrypted file (0x00400000U)
  21               Normal file? (0x00200000U)
  19               Compressed file (0x00080000U)
  17               Sparse file (0x00020000U)
  16               Temporary file (0x00010000U)
  
 

SAMBA maps the bits to Unix permissions thus:

 
   owner        group        world
   r  w  x      r  w  x      r  w  x
   ^  ^  ^            ^            ^
   |  |  |            |            |
   |  |  Archive      System       Hidden
   |  |
   Read only
  
 

The meaning of bits 30, 27, 23, 20 and 15-0 is unknown.

Examples: files.c.

Referenced by datafile_unpack().

char* njb_datafile_struct::folderThis is the name of the folder the file belongs in. All folder names are given with full hierarchy and leading and trailing backslash as in: '\foo\bar\fnord\'. If filename is '.' this is the name of the empty folder.

Examples: files.c.

Referenced by datafile_pack3(), datafile_set_folder(), datafile_unpack(), and NJB_Datafile_Destroy().

njb_datafile_t* njb_datafile_struct::nextdfThis is only to be used internally by libnjb.

u_int32_t njb_datafile_struct::timestampThis is an ordinary UNIX styled timestamp for the file.

Referenced by datafile_pack3(), and datafile_set_time().

Author

Generated automatically by Doxygen for libnjb from the source code.