1 /************************************************************** 2 * 3 * Licensed to the Apache Software Foundation (ASF) under one 4 * or more contributor license agreements. See the NOTICE file 5 * distributed with this work for additional information 6 * regarding copyright ownership. The ASF licenses this file 7 * to you under the Apache License, Version 2.0 (the 8 * "License"); you may not use this file except in compliance 9 * with the License. You may obtain a copy of the License at 10 * 11 * http://www.apache.org/licenses/LICENSE-2.0 12 * 13 * Unless required by applicable law or agreed to in writing, 14 * software distributed under the License is distributed on an 15 * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16 * KIND, either express or implied. See the License for the 17 * specific language governing permissions and limitations 18 * under the License. 19 * 20 *************************************************************/ 21 22 23 #ifndef _OSL_PIPE_DECL_HXX_ 24 #define _OSL_PIPE_DECL_HXX_ 25 26 #include <osl/pipe.h> 27 # include <osl/security.hxx> 28 #include <rtl/ustring.hxx> 29 30 namespace osl { 31 32 class StreamPipe; 33 34 /** Represents a pipe. 35 */ 36 class Pipe 37 { 38 protected: 39 oslPipe m_handle; 40 41 public: 42 43 /** Does not create a pipe. Use assignment operator to 44 make this a useable pipe. 45 */ 46 inline Pipe(); 47 48 /** Creates an insecure pipe that is accessible for all users. 49 @param strName 50 @param Options 51 */ 52 inline Pipe(const ::rtl::OUString& strName, oslPipeOptions Options); 53 54 /** Creates a secure pipe that access depends on the umask settings. 55 @param strName 56 @param Options 57 @param Security 58 */ 59 inline Pipe(const ::rtl::OUString& strName, oslPipeOptions Options,const Security & rSecurity); 60 61 /** Copy constructor. 62 */ 63 inline Pipe(const Pipe& pipe); 64 65 /** Constructs a Pipe reference without acquiring the handle 66 */ 67 inline Pipe( oslPipe pipe, __sal_NoAcquire noacquire ); 68 69 /** Creates pipe as wrapper around the underlying oslPipe. 70 @param Pipe 71 */ 72 inline Pipe(oslPipe Pipe); 73 74 /** Destructor. Destroys the underlying oslPipe. 75 */ 76 inline ~Pipe(); 77 78 inline sal_Bool SAL_CALL is() const; 79 80 /** Creates an insecure pipe that is accessible for all users 81 with the given attributes. 82 If the pipe was already created, the old one will be discarded. 83 @param strName 84 @param Options 85 @param Security 86 @return True if socket was successfully created. 87 */ 88 inline sal_Bool create( const ::rtl::OUString & strName, 89 oslPipeOptions Options, const Security &rSec ); 90 91 /** Creates a secure that access rights depend on the umask settings 92 with the given attributes. 93 94 If socket was already created, the old one will be discarded. 95 @param strName 96 @param Options 97 @return True if socket was successfully created. 98 */ 99 inline sal_Bool create( const ::rtl::OUString & strName, oslPipeOptions Options = osl_Pipe_OPEN ); 100 101 /** releases the underlying handle 102 */ 103 inline void SAL_CALL clear(); 104 105 /** Assignment operator. If pipe was already created, the old one will 106 be discarded. 107 */ 108 inline Pipe& SAL_CALL operator= (const Pipe& pipe); 109 110 /** Assignment operator. If pipe was already created, the old one will 111 be discarded. 112 */ 113 inline Pipe& SAL_CALL operator= (const oslPipe pipe ); 114 115 /** Checks if the pipe is valid. 116 @return True if the object represents a valid pipe. 117 */ 118 inline sal_Bool SAL_CALL isValid() const; 119 120 inline sal_Bool SAL_CALL operator==( const Pipe& rPipe ) const; 121 122 /** Closes the pipe. 123 */ 124 inline void SAL_CALL close(); 125 126 /** Accept connection on an existing pipe 127 */ 128 inline oslPipeError SAL_CALL accept(StreamPipe& Connection); 129 130 131 /** Delivers a constant decribing the last error for the pipe system. 132 @return ENONE if no error occured, invalid_PipeError if 133 an unknown (unmapped) error occured, otherwise an enum describing the 134 error. 135 */ 136 inline oslPipeError SAL_CALL getError() const; 137 138 inline oslPipe SAL_CALL getHandle() const; 139 }; 140 141 /** A pipe to send or receive a stream of data. 142 */ 143 class StreamPipe : public Pipe 144 { 145 public: 146 147 /** Creates an unattached pipe. You must attach the pipe to an oslPipe 148 e.g. by using the operator=(oslPipe), before you can use the stream- 149 functionality of the object. 150 */ 151 inline StreamPipe(); 152 153 /** Creates pipe as wrapper around the underlying oslPipe. 154 @param Pipe 155 */ 156 inline StreamPipe(oslPipe Pipe); 157 158 /** Copy constructor. 159 @param Pipe 160 */ 161 inline StreamPipe(const StreamPipe& Pipe); 162 163 /** Creates a pipe. 164 @param strName 165 @param Options 166 */ 167 inline StreamPipe(const ::rtl::OUString& strName, oslPipeOptions Options = osl_Pipe_OPEN); 168 169 /** Creates a pipe. 170 @param strName 171 @param Options 172 @param rSec 173 */ 174 inline StreamPipe(const ::rtl::OUString& strName, oslPipeOptions Options, const Security &rSec ); 175 176 /** Constructs a Pipe reference without acquiring the handle 177 */ 178 inline StreamPipe( oslPipe pipe, __sal_NoAcquire noacquire ); 179 180 /** Attaches the oslPipe to this object. If the object 181 already was attached to an oslPipe, the old one will 182 be closed and destroyed. 183 @param Pipe. 184 */ 185 inline StreamPipe & SAL_CALL operator=(oslPipe Pipe); 186 187 /** Assignment operator 188 */ 189 inline StreamPipe& SAL_CALL operator=(const Pipe& pipe); 190 191 /** Tries to receives BytesToRead data from the connected pipe, 192 193 @param pBuffer [out] Points to a buffer that will be filled with the received 194 data. 195 @param BytesToRead [in] The number of bytes to read. pBuffer must have at least 196 this size. 197 @return the number of received bytes. 198 */ 199 inline sal_Int32 SAL_CALL recv(void* pBuffer, sal_Int32 BytesToRead) const; 200 201 /** Tries to sends BytesToSend data from the connected pipe. 202 203 @param pBuffer [in] Points to a buffer that contains the send-data. 204 @param BytesToSend [in] The number of bytes to send. pBuffer must have at least 205 this size. 206 @return the number of transfered bytes. 207 */ 208 inline sal_Int32 SAL_CALL send(const void* pBuffer, sal_Int32 BytesToSend) const; 209 210 /** Retrieves n bytes from the stream and copies them into pBuffer. 211 The method avoids incomplete reads due to packet boundaries. 212 @param pBuffer receives the read data. 213 @param n the number of bytes to read. pBuffer must be large enough 214 to hold the n bytes! 215 @return the number of read bytes. The number will only be smaller than 216 n if an exceptional condition (e.g. connection closed) occurs. 217 */ 218 inline sal_Int32 SAL_CALL read(void* pBuffer, sal_Int32 n) const; 219 220 /** Writes n bytes from pBuffer to the stream. The method avoids 221 incomplete writes due to packet boundaries. 222 @param pBuffer contains the data to be written. 223 @param n the number of bytes to write. 224 @return the number of written bytes. The number will only be smaller than 225 n if an exceptional condition (e.g. connection closed) occurs. 226 */ 227 sal_Int32 SAL_CALL write(const void* pBuffer, sal_Int32 n) const; 228 }; 229 230 } 231 #endif 232