1<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"> 2<html> 3<!-- Copyright (C) 1988-2021 Free Software Foundation, Inc. 4 5Permission is granted to copy, distribute and/or modify this document 6under the terms of the GNU Free Documentation License, Version 1.3 or 7any later version published by the Free Software Foundation; with the 8Invariant Sections being "Free Software" and "Free Software Needs 9Free Documentation", with the Front-Cover Texts being "A GNU Manual," 10and with the Back-Cover Texts as in (a) below. 11 12(a) The FSF's Back-Cover Text is: "You are free to copy and modify 13this GNU Manual. Buying copies from GNU Press supports the FSF in 14developing GNU and promoting software freedom." --> 15<!-- Created by GNU Texinfo 5.1, http://www.gnu.org/software/texinfo/ --> 16<head> 17<title>Debugging with GDB: struct stat</title> 18 19<meta name="description" content="Debugging with GDB: struct stat"> 20<meta name="keywords" content="Debugging with GDB: struct stat"> 21<meta name="resource-type" content="document"> 22<meta name="distribution" content="global"> 23<meta name="Generator" content="makeinfo"> 24<meta http-equiv="Content-Type" content="text/html; charset=utf-8"> 25<link href="index.html#Top" rel="start" title="Top"> 26<link href="Concept-Index.html#Concept-Index" rel="index" title="Concept Index"> 27<link href="index.html#SEC_Contents" rel="contents" title="Table of Contents"> 28<link href="Protocol_002dspecific-Representation-of-Datatypes.html#Protocol_002dspecific-Representation-of-Datatypes" rel="up" title="Protocol-specific Representation of Datatypes"> 29<link href="struct-timeval.html#struct-timeval" rel="next" title="struct timeval"> 30<link href="Memory-Transfer.html#Memory-Transfer" rel="previous" title="Memory Transfer"> 31<style type="text/css"> 32<!-- 33a.summary-letter {text-decoration: none} 34blockquote.smallquotation {font-size: smaller} 35div.display {margin-left: 3.2em} 36div.example {margin-left: 3.2em} 37div.indentedblock {margin-left: 3.2em} 38div.lisp {margin-left: 3.2em} 39div.smalldisplay {margin-left: 3.2em} 40div.smallexample {margin-left: 3.2em} 41div.smallindentedblock {margin-left: 3.2em; font-size: smaller} 42div.smalllisp {margin-left: 3.2em} 43kbd {font-style:oblique} 44pre.display {font-family: inherit} 45pre.format {font-family: inherit} 46pre.menu-comment {font-family: serif} 47pre.menu-preformatted {font-family: serif} 48pre.smalldisplay {font-family: inherit; font-size: smaller} 49pre.smallexample {font-size: smaller} 50pre.smallformat {font-family: inherit; font-size: smaller} 51pre.smalllisp {font-size: smaller} 52span.nocodebreak {white-space:nowrap} 53span.nolinebreak {white-space:nowrap} 54span.roman {font-family:serif; font-weight:normal} 55span.sansserif {font-family:sans-serif; font-weight:normal} 56ul.no-bullet {list-style: none} 57--> 58</style> 59 60 61</head> 62 63<body lang="en" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#800080" alink="#FF0000"> 64<a name="struct-stat"></a> 65<div class="header"> 66<p> 67Next: <a href="struct-timeval.html#struct-timeval" accesskey="n" rel="next">struct timeval</a>, Previous: <a href="Memory-Transfer.html#Memory-Transfer" accesskey="p" rel="previous">Memory Transfer</a>, Up: <a href="Protocol_002dspecific-Representation-of-Datatypes.html#Protocol_002dspecific-Representation-of-Datatypes" accesskey="u" rel="up">Protocol-specific Representation of Datatypes</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> 68</div> 69<hr> 70<a name="struct-stat-1"></a> 71<h4 class="unnumberedsubsubsec">struct stat</h4> 72<a name="index-struct-stat_002c-in-file_002di_002fo-protocol"></a> 73 74<p>The buffer of type <code>struct stat</code> used by the target and <small>GDB</small> 75is defined as follows: 76</p> 77<div class="smallexample"> 78<pre class="smallexample">struct stat { 79 unsigned int st_dev; /* device */ 80 unsigned int st_ino; /* inode */ 81 mode_t st_mode; /* protection */ 82 unsigned int st_nlink; /* number of hard links */ 83 unsigned int st_uid; /* user ID of owner */ 84 unsigned int st_gid; /* group ID of owner */ 85 unsigned int st_rdev; /* device type (if inode device) */ 86 unsigned long st_size; /* total size, in bytes */ 87 unsigned long st_blksize; /* blocksize for filesystem I/O */ 88 unsigned long st_blocks; /* number of blocks allocated */ 89 time_t st_atime; /* time of last access */ 90 time_t st_mtime; /* time of last modification */ 91 time_t st_ctime; /* time of last change */ 92}; 93</pre></div> 94 95<p>The integral datatypes conform to the definitions given in the 96appropriate section (see <a href="Integral-Datatypes.html#Integral-Datatypes">Integral Datatypes</a>, for details) so this 97structure is of size 64 bytes. 98</p> 99<p>The values of several fields have a restricted meaning and/or 100range of values. 101</p> 102<dl compact="compact"> 103<dt><code>st_dev</code></dt> 104<dd><p>A value of 0 represents a file, 1 the console. 105</p> 106</dd> 107<dt><code>st_ino</code></dt> 108<dd><p>No valid meaning for the target. Transmitted unchanged. 109</p> 110</dd> 111<dt><code>st_mode</code></dt> 112<dd><p>Valid mode bits are described in <a href="Constants.html#Constants">Constants</a>. Any other 113bits have currently no meaning for the target. 114</p> 115</dd> 116<dt><code>st_uid</code></dt> 117<dt><code>st_gid</code></dt> 118<dt><code>st_rdev</code></dt> 119<dd><p>No valid meaning for the target. Transmitted unchanged. 120</p> 121</dd> 122<dt><code>st_atime</code></dt> 123<dt><code>st_mtime</code></dt> 124<dt><code>st_ctime</code></dt> 125<dd><p>These values have a host and file system dependent 126accuracy. Especially on Windows hosts, the file system may not 127support exact timing values. 128</p></dd> 129</dl> 130 131<p>The target gets a <code>struct stat</code> of the above representation and is 132responsible for coercing it to the target representation before 133continuing. 134</p> 135<p>Note that due to size differences between the host, target, and protocol 136representations of <code>struct stat</code> members, these members could eventually 137get truncated on the target. 138</p> 139<hr> 140<div class="header"> 141<p> 142Next: <a href="struct-timeval.html#struct-timeval" accesskey="n" rel="next">struct timeval</a>, Previous: <a href="Memory-Transfer.html#Memory-Transfer" accesskey="p" rel="previous">Memory Transfer</a>, Up: <a href="Protocol_002dspecific-Representation-of-Datatypes.html#Protocol_002dspecific-Representation-of-Datatypes" accesskey="u" rel="up">Protocol-specific Representation of Datatypes</a> [<a href="index.html#SEC_Contents" title="Table of contents" rel="contents">Contents</a>][<a href="Concept-Index.html#Concept-Index" title="Index" rel="index">Index</a>]</p> 143</div> 144 145 146 147</body> 148</html> 149