*nix Documentation Project
·  Home
 +   man pages
·  Linux HOWTOs
·  FreeBSD Tips
·  *niX Forums

  man pages->IRIX man pages -> f90/pxfchroot (3)              
Title
Content
Arch
Section
 

Contents


PXFCHROOT(3F)					       Last changed: 1-6-98

NAME    [Toc]    [Back]

     PXFCHROOT - Changes the root directory to a specified directory

SYNOPSIS    [Toc]    [Back]

     CHARACTER*n path
     INTEGER ilen, ierror
     CALL PXFCHROOT(path, ilen,	ierror)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     IEEE standard interface for FORTRAN 77

DESCRIPTION    [Toc]    [Back]

     On	IRIX systems, this routine is in libfortran.so which is	linked by
     default when compiling programs with the MIPSpro 7	Fortran	90 compiler
     or	when compiling programs	with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     The PXFCHROOT subroutine uses the chroot(2) system	call to	change the
     root directory to the specified directory.

     When using	the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk,	or IRIX	systems, all arguments must be of default
     kind unless documented otherwise.	On UNICOS and UNICOS/mk, default
     kind is KIND=8 for	integer, real, complex,	and logical arguments; on
     IRIX, the default kind is KIND=4.

     The following is a	list of	valid arguments	for this subroutine:

     path      Input character variable	or array element containing the
	       name of a file.

     ilen      Input integer variable containing the length of path in
	       characters.  If ilen is zero, all trailing blanks are
	       removed before calling chroot().

     ierror    Output integer variable that contains zero if the root
	       directory was changed to	the directory specified	by path	or
	       nonzero if the root directory was not changed.

     In	addition to the	errors returned	by the chroot(2) system	call,
     PXFCHROOT may return the following	errors:

     EINVAL    If ilen is less than 0 or if ilen is greater than LEN(path)

     ENOMEM    If PXFCHROOT is unable to obtain	memory to copy path

EXAMPLES    [Toc]    [Back]

	  program test
	  character*(12) path
	  integer ilen,	ierr
	  path = '/dir/test'
	  ilen = 0
	  call pxfchroot(path,ilen,ierr)
	  if (ierr.ne.0) then
	      print *,'FAIL: error from	pxfchroot = ',ierr
	  else
	      print *,'PASS: No	error from pxfchroot'
	  endif
	  end

SEE ALSO    [Toc]    [Back]

      
      
     chroot(2)

     Application Programmer's Library Reference	Manual,	publication SR2165,
 for the printed version of this man page.

PXFCHROOT(3F)					       Last changed: 1-6-98

NAME    [Toc]    [Back]

     PXFCHROOT - Changes the root directory to a specified directory

SYNOPSIS    [Toc]    [Back]

     CHARACTER*n path
     INTEGER ilen, ierror
     CALL PXFCHROOT(path, ilen,	ierror)

IMPLEMENTATION    [Toc]    [Back]

     UNICOS, UNICOS/mk,	and IRIX systems

STANDARDS    [Toc]    [Back]

     IEEE standard interface for FORTRAN 77

DESCRIPTION    [Toc]    [Back]

     On	IRIX systems, this routine is in libfortran.so which is	linked by
     default when compiling programs with the MIPSpro 7	Fortran	90 compiler
     or	when compiling programs	with the -craylibs option to the MIPSpro
     7.2 F77 compiler.

     The PXFCHROOT subroutine uses the chroot(2) system	call to	change the
     root directory to the specified directory.

     When using	the CF90 compiler or MIPSpro 7 Fortran 90 compiler on
     UNICOS, UNICOS/mk,	or IRIX	systems, all arguments must be of default
     kind unless documented otherwise.	On UNICOS and UNICOS/mk, default
     kind is KIND=8 for	integer, real, complex,	and logical arguments; on
     IRIX, the default kind is KIND=4.

     The following is a	list of	valid arguments	for this subroutine:

     path      Input character variable	or array element containing the
	       name of a file.

     ilen      Input integer variable containing the length of path in
	       characters.  If ilen is zero, all trailing blanks are
	       removed before calling chroot().

     ierror    Output integer variable that contains zero if the root
	       directory was changed to	the directory specified	by path	or
	       nonzero if the root directory was not changed.

     In	addition to the	errors returned	by the chroot(2) system	call,
     PXFCHROOT may return the following	errors:

     EINVAL    If ilen is less than 0 or if ilen is greater than LEN(path)

     ENOMEM    If PXFCHROOT is unable to obtain	memory to copy path

EXAMPLES    [Toc]    [Back]

	  program test
	  character*(12) path
	  integer ilen,	ierr
	  path = '/dir/test'
	  ilen = 0
	  call pxfchroot(path,ilen,ierr)
	  if (ierr.ne.0) then
	      print *,'FAIL: error from	pxfchroot = ',ierr
	  else
	      print *,'PASS: No	error from pxfchroot'
	  endif
	  end

SEE ALSO    [Toc]    [Back]

      
      
     chroot(2)

     Application Programmer's Library Reference	Manual,	publication SR2165,
 for the printed version of this man page.

[ Back ]
 Similar pages
Name OS Title
chroot OpenBSD change root directory
chroot OpenBSD change root directory
chroot FreeBSD change root directory
fchroot NetBSD change root directory
chroot NetBSD change root directory
chroot Tru64 Changes the root directory of a command
chroot FreeBSD change root directory
chroot Linux change root directory
chroot HP-UX change root directory
chroot IRIX change root directory
Copyright © 2004-2005 DeniX Solutions SRL
newsletter delivery service