This file is indexed.

/usr/include/simgear/io/sg_serial.hxx is in libsimgear-dev 3.0.0-1.

This file is owned by root:root, with mode 0o644.

The actual contents of the file can be viewed below.

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
/**
 * \file sg_serial.hxx
 * Serial I/O routines
 */

// Written by Curtis Olson, started November 1999.
//
// Copyright (C) 1999  Curtis L. Olson - http://www.flightgear.org/~curt
//
// This program is free software; you can redistribute it and/or
// modify it under the terms of the GNU General Public License as
// published by the Free Software Foundation; either version 2 of the
// License, or (at your option) any later version.
//
// This program is distributed in the hope that it will be useful, but
// WITHOUT ANY WARRANTY; without even the implied warranty of
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
// General Public License for more details.
//
// You should have received a copy of the GNU General Public License
// along with this program; if not, write to the Free Software
// Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301, USA.
//
// $Id$


#ifndef _SG_SERIAL_HXX
#define _SG_SERIAL_HXX


#ifndef __cplusplus
# error This library requires C++
#endif

#include <simgear/compiler.h>

#include <string>

#include <simgear/serial/serial.hxx>

#include "iochannel.hxx"

/**
 * A serial I/O class based on SGIOChannel.
 */
class SGSerial : public SGIOChannel {

    std::string device;
    std::string baud;
    SGSerialPort port;

    char save_buf[ 2 * SG_IO_MAX_MSG_SIZE ];
    int save_len;

public:

    /**
     * Create an instance of SGSerial.
     * This creates an instance of the SGSerial class. You need to
     * provide the serial device name and desired baud rate.  For Unix
     * style systems, device names will be similar to
     * ``/dev/ttyS0''. For DOS style systems you may want to use
     * something similar to ``COM1:''. As with the SGFile class,
     * device is not opened immediately, but instead will be opened
     * when the open() method is called.
     * @param device_name name of serial device
     * @param baud_rate speed of communication
     */
    SGSerial( const std::string& device_name, const std::string& baud_rate );

    /** Destructor */
    ~SGSerial();

    // open the serial port based on specified direction
    bool open( const SGProtocolDir d );

    // read a block of data of specified size
    int read( char *buf, int length );

    // read a line of data, length is max size of input buffer
    int readline( char *buf, int length );

    // write data to port
    int write( const char *buf, const int length );

    // write null terminated string to port
    int writestring( const char *str );

    // close port
    bool close();

    /** @return the serial port device name */
    inline string get_device() const { return device; }

    /** @return the baud rate */
    inline string get_baud() const { return baud; }
};


#endif // _SG_SERIAL_HXX