mk

Algorithms for Image Processing and Computer Vision Source Code

@c ----------------------------------------------------------------------
@node mkdir, file system
@heading @code{mkdir}
@subheading Syntax

@example
#include <osfcn.h>

int mkdir(const char *path, int mode);
@end example

@subheading Description

This function creates a subdirectory.  The @var{mode} field is ignored
under MS-DOS. 

@subheading Return Value

Zero if the subdirectory was created, nonzero on failure.

@subheading Example

@example
mkdir("/usr/tmp");
@end example

@c ----------------------------------------------------------------------
@node mkfifo, unix
@heading @code{mkfifo}

@subheading Description

This function is provided only to assist in porting from Unix.  It
always returns an error condition. 

@c ----------------------------------------------------------------------
@node mknod, unix
@heading @code{mknod}

@subheading Description

This function is provided only to assist in porting from Unix.  It
always returns an error condition. 

@c ----------------------------------------------------------------------
@node mkstemp, file system
@heading @code{mkstemp}
@subheading Syntax

@example
#include <stdio.h>

int mkstemp(char *template);
@end example

@subheading Description

@var{template} is a file specification that ends with six trailing
@code{X} characters.  This function replaces the @code{XXXXXX} with a
set of characters such that the resulting file name names a nonexisting
file.  It then creates and opens the file. 

Note that since MS-DOS is limited to eight characters for the file name,
and since none of the @code{X}'s get replaced by a dot, you can only
have two additional characters before the @code{X}'s. 

@subheading Return Value

The open file descriptor.

@subheading Example

@example
int fd = mkstemp("/tmp/ccXXXXXX");
@end example

@c ----------------------------------------------------------------------
@node mktemp, file system
@heading @code{mktemp}
@subheading Syntax

@example
#include <stdio.h>

char *mktemp(char *template);
@end example

@subheading Description

@var{template} is a file specification that ends with six trailing
@code{X} characters.  This function replaces the @code{XXXXXX} with a
set of characters such that the resulting file name names a nonexisting
file.

Note that since MS-DOS is limited to eight characters for the file name,
and since none of the @code{X}'s get replaced by a dot, you can only
have two additional characters before the @code{X}'s. 

@subheading Return Value

The resulting filename.

@subheading Example

@example
char template[] = "/tmp/ccXXXXXX";
mktemp(template);
FILE *q = fopen(template, "w");
@end example

@c ----------------------------------------------------------------------
@node mktime, time
@heading @code{mktime}
@subheading Syntax

@example
#include <time.h>

time_t mktime(struct tm *tptr);
@end example

@subheading Description

This function converts a time structure into the number of seconds since
00:00:00 GMT 1/1/1970.  It also attempts to normalize the fields of
@var{tptr}. 

@subheading Return Value

The resulting time, or -1 if the time in @var{tptr} cannot be described
in that format.