libc structures¶

Idio supports the passing of opaque C pointers as the C/pointer type.

Those C/pointers can be tagged with some type information which can be used for access, setting (if appropriate) and printing.

struct group¶

Idio supports tagged references to C struct group:

struct group
{
    char   *gr_name;
    char   *gr_passwd;
    gid_t   gr_gid;
    char  **gr_mem;
};

struct passwd¶

Idio supports tagged references to C struct passwd:

struct passwd
{
    char   *pw_name;
    char   *pw_passwd;
    uid_t   pw_uid;
    gid_t   pw_gid;
    char   *pw_gecos;
    char   *pw_dir;
    char   *pw_shell;
};

struct rlimit¶

Idio supports tagged references to C struct rlimit:

struct rlimit
{
  rlim_t               rlim_cur;
  rlim_t               rlim_max;
};

using the structure member names rlim_cur and rlim_max.

struct rusage¶

Idio supports tagged references to C struct rusage:

struct rusage
{
  struct timeval       ru_utime;
  struct timeval       ru_stime;
};

using the structure member names ru_utime and ru_stime for struct-timeval structures. The other member names are not accessible due to portability concerns.

struct stat¶

Idio supports tagged references to C struct stat:

struct stat
{
  dev_t                st_dev;
  ino_t                st_ino;
  nlink_t              st_nlink;
  mode_t               st_mode;
  uid_t                st_uid;
  gid_t                st_gid;
  dev_t                st_rdev;
  off_t                st_size;
  blksize_t            st_blksize;
  blkcnt_t             st_blocks;
  struct timespec      st_atim;
  struct timespec      st_mtim;
  struct timespec      st_ctim;
};

using the structure member names st_dev, st_ino etc..

In addition the pseudo-member names st_atime, st_mtime and st_ctime will access the tv_sec member of the corresponding struct-timespec members to maintain the legacy interface.

struct statvfs¶

Idio supports tagged references to C struct statvfs:

struct statvfs
{
    unsigned long  f_bsize;
    unsigned long  f_frsize;
    fsblkcnt_t     f_blocks;
    fsblkcnt_t     f_bfree;
    fsblkcnt_t     f_bavail;
    fsfilcnt_t     f_files;
    fsfilcnt_t     f_ffree;
    fsfilcnt_t     f_favail;
    unsigned long  f_fsid;
    unsigned long  f_flag;
    unsigned long  f_namemax;
};

using the structure member names f_bsize, f_frsize etc..

struct termios¶

Idio supports tagged references to C struct termios:

struct termios
{
  tcflag_t             c_iflag;
  tcflag_t             c_oflag;
  tcflag_t             c_cflag;
  tcflag_t             c_lflag;
  cc_t[]               c_cc;
  speed_t              c_ispeed;
  speed_t              c_ospeed;
};

using the structure member names c_iflag, c_oflag etc..

Note that SunOS does not define either of c_ispeed or c_ospeed and OpenBSD defines speed_t as an int.

Linux’s c_line is not supported.

struct timespec¶

Idio supports tagged references to C struct timespec:

struct timespec
{
  time_t               tv_sec;
  long                 tv_nsec;
};

using the structure member names tv_sec and tv_nsec.

Note that tv_nsec is defined as a long due to portability issues.

function libc/struct-timespec-ref timespec member¶

in C, timespec->member

Param timespec:: struct-timespec
Type timespec:: C/pointer
Param member:: member name
Type member:: symbol
Return:: timespec -> member
Rtype:: varies on member

function libc/struct-timespec-set! timespec member val¶

in C, timespec->member = val

Param timespec:: struct-timespec
Type timespec:: C/pointer
Param member:: member name
Type member:: symbol
Param val:: a C/ type
Type val:: varies on member
Return:: #<unspec>

The C/ types for val are libc/time_t, C/long.

function libc/struct-timespec-as-string timespec¶

Param timespec:: struct-timespec
Type timespec:: C/pointer
Return:: string
Rtype:: string

struct-timespec-as-string is set to be the printer for a libc/struct-timespec.

The code prints the structure in a pseudo-floating point format: tv_sec.tv_nsec with the tv_nsec part formatted to 9 digits with leading 0 (zero) padding.

struct timeval¶

Idio supports tagged references to C struct timeval:

struct timeval
{
  time_t             tv_sec;
  suseconds_t        tv_usec;
};

using the structure member names tv_sec and tv_usec.

Note that on some systems suseconds_t may be typedef’d to a long.

struct tm¶

Idio supports tagged references to C struct tm:

struct tm
{
  int                  tm_sec;
  int                  tm_min;
  int                  tm_hour;
  int                  tm_mday;
  int                  tm_mon;
  int                  tm_year;
  int                  tm_wday;
  int                  tm_yday;
  int                  tm_isdst;
  long int             tm_gmtoff;
  char*                tm_zone;
};

using the structure member names tm_sec, tm_min etc..

Note that SunOS does not define tm_gmtoff or tm_zone.

See also asctime, localtime, gmtime, mktime, strftime, strptime.

function libc/struct-tm-ref tm member¶

in C, tm->member

Param tm:: struct-tm
Type tm:: C/pointer
Param member:: member name
Type member:: symbol
Return:: tm -> member
Rtype:: varies on member

function libc/struct-tm-set! tm member val¶

in C, tm->member = val

Param tm:: struct-tm
Type tm:: C/pointer
Param member:: member name
Type member:: symbol
Param val:: a C/ type
Type val:: varies on member
Return:: #<unspec>

The C/ types for val are C/int, C/long and C/pointer for tm_zone.

function libc/struct-tm-as-string tm¶

Param tm:: struct-tm
Type tm:: C/pointer
Return:: string
Rtype:: string

struct-tm-as-string is set to be the printer for a libc/struct-tm.

struct tms¶

Idio supports tagged references to C struct tms:

struct tms
{
  clock_t              tms_utime;
  clock_t              tms_stime;
  clock_t              tms_cutime;
  clock_t              tms_cstime;
};

using the structure member names tms_utime, tms_stime etc..

struct utsname¶

Idio supports tagged references to C struct utsname:

struct utsname
{
  char[]               sysname;
  char[]               nodename;
  char[]               release;
  char[]               version;
  char[]               machine;
  char[]               domainname;
};

using the structure member names sysname, nodename etc..

Note that domainname is only available on Linux.