source: mainline/tools/mkhord.py@ b3105ff6

#!/usr/bin/env python
#
# Copyright (c) 2008 Martin Decky
# All rights reserved.
#
# Redistribution and use in source and binary forms, with or without
# modification, are permitted provided that the following conditions
# are met:
#
# - Redistributions of source code must retain the above copyright
#   notice, this list of conditions and the following disclaimer.
# - Redistributions in binary form must reproduce the above copyright
#   notice, this list of conditions and the following disclaimer in the
#   documentation and/or other materials provided with the distribution.
# - The name of the author may not be used to endorse or promote products
#   derived from this software without specific prior written permission.
#
# THIS SOFTWARE IS PROVIDED BY THE AUTHOR ``AS IS'' AND ANY EXPRESS OR
# IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES
# OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED.
# IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR ANY DIRECT, INDIRECT,
# INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT
# NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
# DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
# THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
# (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF
# THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
#
"""
HORD encapsulator
"""

import sys
import os
import struct
import xstruct

HEADER = xstruct.convert("little: "
        "char[4]   /* 'HORD' */ "
        "uint8_t   /* version */ "
        "uint8_t   /* encoding */ "
        "uint32_t  /* header size */ "
        "uint64_t  /* payload size */ "
)

HORD_VERSION = 1
HORD_LSB = 1

def align_up(size, alignment):
        "Align upwards to a given alignment"
        return (((size) + ((alignment) - 1)) & ~((alignment) - 1))

def usage(prname):
        "Print usage syntax"
        print prname + " <ALIGNMENT> <FS_IMAGE> <HORD_IMAGE>" 

def main():
        if (len(sys.argv) < 4):
                usage(sys.argv[0])
                return
        
        if (not sys.argv[1].isdigit()):
                print "<ALIGNMENT> must be a number"
                return
        
        align = int(sys.argv[1], 0)
        if (align <= 0):
                print "<ALIGNMENT> must be positive"
                return
        
        fs_image = os.path.abspath(sys.argv[2])
        if (not os.path.isfile(fs_image)):
                print "<FS_IMAGE> must be a file"
                return
        
        inf = file(fs_image, "rb")
        outf = file(sys.argv[3], "wb")
        
        header_size = struct.calcsize(HEADER)
        payload_size = os.path.getsize(fs_image)
        
        header_size_aligned = align_up(header_size, align)
        payload_size_aligned = align_up(payload_size, align)
        
        outf.write(struct.pack(HEADER, "HORD", HORD_VERSION, HORD_LSB, header_size_aligned, payload_size_aligned))
        outf.write(xstruct.little_padding(header_size_aligned - header_size))
        
        outf.write(inf.read())
        
        padding = payload_size_aligned - payload_size
        if (padding > 0):
                outf.write(xstruct.little_padding(padding))
        
        inf.close()
        outf.close()

if __name__ == '__main__':
        main()