git.infodrom.org Git - infodrom/manpages-de/blob - man2/utime.2

   1 .\" Hey Emacs! This file is -*- nroff -*- source.
   2 .\"
   3 .\" Copyright (c) 1992 Drew Eckhardt (drew@cs.colorado.edu), March 28, 1992
   4 .\"
   5 .\" Permission is granted to make and distribute verbatim copies of this
   6 .\" manual provided the copyright notice and this permission notice are
   7 .\" preserved on all copies.
   8 .\"
   9 .\" Permission is granted to copy and distribute modified versions of this
  10 .\" manual under the conditions for verbatim copying, provided that the
  11 .\" entire resulting derived work is distributed under the terms of a
  12 .\" permission notice identical to this one
  13 .\"
  14 .\" Since the Linux kernel and libraries are constantly changing, this
  15 .\" manual page may be incorrect or out-of-date.  The author(s) assume no
  16 .\" responsibility for errors or omissions, or for damages resulting from
  17 .\" the use of the information contained herein.  The author(s) may not
  18 .\" have taken the same level of care in the production of this manual,
  19 .\" which is licensed free of charge, as they might when working
  20 .\" professionally.
  21 .\"
  22 .\" Formatted or processed versions of this manual, if unaccompanied by
  23 .\" the source, must acknowledge the copyright and authors of this work.
  24 .\"
  25 .\" Modified by Michael Haardt (u31b3hs@pool.informatik.rwth-aachen.de)
  26 .\" Modified Sat Jul 24 13:03:05 1993 by Rik Faith (faith@cs.unc.edu)
  27 .\" Modified 10 June 1995 by Andries Brouwer (aeb@cwi.nl)
  28 .\" Translated to German Sat Jun 01 12:15:00 1996 by Patrick Rother <krd@gulu.net>
  29 .\"
  30 .TH UTIME 2 "1. Juni 1996" "Linux" "Systemaufrufe"
  31 .SH BEZEICHNUNG
  32 utime, utimes \- ändere Zugriffs- und/oder Modifikations-Zeiten eines inode
  33 .SH ÜBERSICHT
  34 .B #include <sys/types.h>
  35 .br
  36 .B #include <utime.h>
  37 .sp
  38 .BI "int utime(const char *" filename ", struct utimbuf *" buf );
  39 .sp 2
  40 .B #include <sys/time.h>
  41 .sp
  42 .BI "int utimes(char *" filename ", struct timeval *" tvp );
  43 .SH BESCHREIBUNG
  44 .B utime
  45 ändert die Zugriffs- und Modifikations-Zeiten des inode, der durch
  46 .I filename
  47 angegeben ist, in die Felder
  48 .IR actime " und " modtime
  49 von
  50 .I buf .
  51 Wenn
  52 .I buf
  53 .BR NULL
  54 ist, dann werden Zugriffs- und Modifikations-Zeiten auf die aktuelle Zeit
  55 gesetzt
  56 Die Struktur
  57 .I utimbuf
  58 ist:
  59
  60 .RS
  61 .nf
  62 struct utimbuf {
  63         time_t actime;  /* Zugriffszeit */
  64         time_t modtime; /* Modifikationszeit */
  65 };
  66 .fi
  67 .RE
  68
  69 In den Linux DLL 4.4.1 - Bibliotheken ist
  70 .B utimes
  71 nur ein Umschlag für
  72 .BR utime :
  73 .IR tvp [0]. tv_sec
  74 ist
  75 .IR actime ,
  76 und
  77 .IR tvp [1]. tv_sec
  78 ist
  79 .IR modtime .
  80 Die Struktur
  81 .I timeval
  82 ist:
  83
  84 .RS
  85 .nf
  86 struct timeval {
  87         long    tv_sec;         /* Sekunden */
  88         long    tv_usec;        /* Microsekunden */
  89 };
  90 .fi
  91 .RE
  92 .SH "RÜCKGABEWERT"
  93 Bei Erfolg wird Null zurückgegeben.  Im Fehlerfall wird \-1 zurückgegeben und
  94 .I errno
  95 entsprechend gesetzt.
  96 .SH FEHLER
  97 Andere Fehler können Auftreten.
  98
  99 .TP 0.8i
 100 .B EACCESS
 101 Zugriff in die Datei zu schreiben wurde verweigert.
 102 .TP
 103 .B ENOENT
 104 .I filename
 105 existiert nicht.
 106 .SH "KONFORM ZU"
 107 .BR utime :
 108 SVID, POSIX
 109 .br
 110 .BR utimes :
 111 BSD 4.3
 112 .SH "SIEHE AUCH"
 113 .BR stat (2).