This file is indexed.

/usr/include/smbios/ICmosRW.h is in libsmbios-dev 2.3.0-0ubuntu1.

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
101
102
103
// vim:expandtab:autoindent:tabstop=4:shiftwidth=4:filetype=c:
/*
 * Copyright (C) 2005 Dell Inc.
 *  by Michael Brown <Michael_E_Brown@dell.com>
 * Licensed under the Open Software License version 2.1
 *
 * Alternatively, 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.
 */


#ifndef ICMOSRW_H
#define ICMOSRW_H

// compat header should always be first header
#include "smbios/compat.h"

// types.h should be first user-defined header.
#include "smbios/types.h"

#include "smbios/IFactory.h"
#include "smbios/IException.h"

// abi_prefix should be last header included before declarations
#include "smbios/config/abi_prefix.hpp"

namespace cmos
{
    //! Abstract base class for the cmos read write operations
    /**
    */
    // Exceptions
    DECLARE_EXCEPTION( CmosException );
    DECLARE_EXCEPTION_EX( InvalidCmosRWMode, cmos, CmosException );

    // forward declarations.
    class ICmosRW;

    class CmosRWFactory : public virtual factory::IFactory
    {
    public:
        static CmosRWFactory *getFactory();
        virtual ~CmosRWFactory() throw();
        virtual ICmosRW *getSingleton( ) = 0; // returns singleton
        virtual ICmosRW *makeNew( ) = 0; // not for use
    protected:
        CmosRWFactory();
    };

    class ICmosRW
    {
    public:
        explicit ICmosRW();
        virtual u8 readByte( u32 indexPort, u32 dataPort, u32 offset ) const = 0;
        virtual void writeByte( u32 indexPort, u32 dataPort, u32 offset, u8 byte ) const = 0;
        virtual ~ICmosRW();
    private:
        ICmosRW( const ICmosRW &source ); ///< NOT ALLOWED. No copy constructor
        void operator = (const ICmosRW &source ); ///< NOT ALLOWED. No overloaded assignment
    };

    /** Read or write an array of bytes to CMOS.
     *
     * This function is set up as a non-member helper function. It successively reads/writes \param count bytes from/to CMOS.
     *
     * Note that the byte array passed as a parameter need not be zero-terminated.
     *
     * \param cmos Pass in the ICmosRW object to operate on
     * \param indexPort The IO port to write the offset to
     * \param dataPort The IO port to read/write data after setting the index via indexPort
     * \param offset The offset within CMOS. CMOS is typically multiple 256byte pages.
     * \param target Byte array to store the results. Call must already have allocated.
     * \param count The number of bytes to read/write.
     */
    void readByteArray( const ICmosRW &cmos, u32 indexPort, u32 dataPort, u32 offset, u8* target, u32 count);
    /** Read or write an array of bytes to CMOS.
     *
     * This function is set up as a non-member helper function. It successively reads/writes \param count bytes from/to CMOS.
     *
     * Note that the byte array passed as a parameter need not be zero-terminated.
     *
     * \param cmos Pass in the ICmosRW object to operate on
     * \param indexPort The IO port to write the offset to
     * \param dataPort The IO port to read/write data after setting the index via indexPort
     * \param offset The offset within CMOS. CMOS is typically multiple 256byte pages.
     * \param source byte array to store the CMOS contents. must be allocated by caller.
     * \param count The number of bytes to read/write.
     * */
    void writeByteArray( const ICmosRW &cmos, u32 indexPort, u32 dataPort, u32 offset, const u8* source, u32 count);

}

// always should be last thing in header file
#include "smbios/config/abi_suffix.hpp"

#endif  /* ICMOSRW_H */