GSP
Quick Navigator

Search Site

Unix VPS
A - Starter
B - Basic
C - Preferred
D - Commercial
MPS - Dedicated
Previous VPSs
* Sign Up! *

Support
Contact Us
Online Help
Handbooks
Domain Status
Man Pages

FAQ
Virtual Servers
Pricing
Billing
Technical

Network
Facilities
Connectivity
Topology Map

Miscellaneous
Server Agreement
Year 2038
Credits
 

USA Flag

 

 

Man Pages


Manual Reference Pages  -  FD2 (1)

NAME

fd2 - redirect from/to file descriptor 2

CONTENTS

Synopsis
Description
Environment
Examples
Author
License
Copyright

SYNOPSIS

fd2 [-e] [-f file] [--] command [arg ...]

DESCRIPTION

Since the Sixth Edition UNIX shell provides no way to redirect the diagnostic output, fd2 makes this possible by executing the specified command with the given arguments and redirecting file descriptor 2 (standard error) to file descriptor 1 (standard output) by default.

The options are as follows:
-e Causes all conventional output from command to be redirected to the standard error as diagnostic output.
-f file Causes all diagnostic output from command to be redirected to file, which is created if it does not exist. If it already exists, all diagnostic output is appended to the end of file.
-- Causes fd2 to stop further option processing, forcing it to treat all following arguments as command [arg ...] .

EXIT STATUS

If fd2 detects an error, it prints an appropriate diagnostic and exits with a non-zero status. Otherwise, the exit status is that of the executed command.

ENVIRONMENT

EXECSHELL
  If set to a non-empty string, the value of this variable is taken as the path name of the shell which is invoked to execute the specified command when it does not begin with the proper magic number or a ‘#!shell’ sequence.
PATH If set to a non-empty string, the value of this variable is taken as the sequence of directories which is used to search for the specified command.

EXAMPLES

The examples below which refer to ‘/tmp/$$’ assume that this directory exists and is writable by the user. The following command line:

fd2 -e echo progname: Error message

causes all conventional output from echo to be redirected to the standard error as diagnostic output. The following command line:

fd2 make foo >/tmp/$$/foo.outerr

causes all conventional and diagnostic output from make to be redirected to the file ‘/tmp/$$/foo.outerr’, which is first created by the shell. In contrast:

fd2 -f /tmp/$$/foo.err make foo >/tmp/$$/foo.out

causes all conventional output to be redirected to the file ‘/tmp/$$/foo.out’, which is created by the shell. All diagnostic output is redirected to the file ‘/tmp/$$/foo.err’, which is created by fd2 if it does not already exist.

SEE ALSO

osh(1), sh6(1)

Osh home page: http://v6shell.org/

AUTHOR

This implementation of fd2 is written by Jeffrey Allen Neitzel.

LICENSE

See either the LICENSE file which is distributed with osh or http://v6shell.org/license/ for full details.

COPYRIGHT

Copyright (c) 2005-2016
        Jeffrey Allen Neitzel.  All rights reserved.

Copyright (c) 1985, 1989, 1991, 1993         The Regents of the University of California. All rights reserved.

Search for    or go to Top of page |  Section 1 |  Main Index


osh-20160108 FD2 (1) January 7, 2016

Powered by GSP Visit the GSP FreeBSD Man Page Interface.
Output converted with manServer 1.07.