xref: /freebsd/contrib/kyua/utils/process/fdstream.cpp (revision b0d29bc47dba79f6f38e67eabadfb4b32ffd9390)
1  // Copyright 2010 The Kyua Authors.
2  // All rights reserved.
3  //
4  // Redistribution and use in source and binary forms, with or without
5  // modification, are permitted provided that the following conditions are
6  // met:
7  //
8  // * Redistributions of source code must retain the above copyright
9  //   notice, this list of conditions and the following disclaimer.
10  // * Redistributions in binary form must reproduce the above copyright
11  //   notice, this list of conditions and the following disclaimer in the
12  //   documentation and/or other materials provided with the distribution.
13  // * Neither the name of Google Inc. nor the names of its contributors
14  //   may be used to endorse or promote products derived from this software
15  //   without specific prior written permission.
16  //
17  // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
18  // "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
19  // LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
20  // A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
21  // OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
22  // SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
23  // LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
24  // DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
25  // THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
26  // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
27  // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
28  
29  #include "utils/process/fdstream.hpp"
30  
31  #include "utils/noncopyable.hpp"
32  #include "utils/process/systembuf.hpp"
33  
34  
35  namespace utils {
36  namespace process {
37  
38  
39  /// Private implementation fields for ifdstream.
40  struct ifdstream::impl : utils::noncopyable {
41      /// The systembuf backing this file descriptor.
42      systembuf _systembuf;
43  
44      /// Initializes private implementation data.
45      ///
46      /// \param fd The file descriptor.
implutils::process::ifdstream::impl47      impl(const int fd) : _systembuf(fd) {}
48  };
49  
50  
51  }  // namespace process
52  }  // namespace utils
53  
54  
55  namespace process = utils::process;
56  
57  
58  /// Constructs a new ifdstream based on an open file descriptor.
59  ///
60  /// This grabs ownership of the file descriptor.
61  ///
62  /// \param fd The file descriptor to read from.  Must be open and valid.
ifdstream(const int fd)63  process::ifdstream::ifdstream(const int fd) :
64      std::istream(NULL),
65      _pimpl(new impl(fd))
66  {
67      rdbuf(&_pimpl->_systembuf);
68  }
69  
70  
71  /// Destroys an ifdstream object.
72  ///
73  /// \post The file descriptor attached to this stream is closed.
~ifdstream(void)74  process::ifdstream::~ifdstream(void)
75  {
76  }
77