winebuild-development - Online na nuvem

PROGRAMA:

NOME

winebuild - construtor Wine dll

SINOPSE

construção de vinho [opções] [Arquivo de entrada...]

DESCRIÇÃO

construção de vinho gera os arquivos de montagem que são necessários para construir uma dll do Wine, que é
basicamente uma DLL Win32 encapsulada dentro de uma biblioteca Unix.

construção de vinho tem modos diferentes, dependendo do tipo de arquivo que é solicitado a gerar. o
modo é especificado por uma das opções de modo especificadas abaixo. Além do modo
opção, várias outras opções de linha de comando podem ser especificadas, conforme descrito no OPÇÕES
seção.

MODA OPÇÕES

Você deve especificar exatamente uma das seguintes opções, dependendo do que deseja
winebuild para gerar.

--dll Construir um arquivo de montagem a partir de um arquivo .spec (ver SPEC ARQUIVO SINTAXE para detalhes), ou
de um arquivo .def padrão do Windows. O arquivo .spec / .def é especificado por meio do -E
opção. O arquivo resultante deve ser montado e vinculado aos outros arquivos objeto
para construir um Wine dll funcional. Neste modo, o entrada arquivos deve ser a lista de
todos os arquivos de objeto que serão vinculados à dll final, para permitir construção de vinho para obter
a lista de todos os símbolos indefinidos que precisam ser importados de outras dlls.

--Exe Crie um arquivo de montagem para um executável. Isso é basicamente o mesmo que --dll
modo, exceto que não requer um arquivo .spec / .def como entrada, uma vez que um executável
não precisa exportar funções. Alguns executáveis, no entanto, exportam funções, e para
aqueles um arquivo .spec / .def podem ser especificados por meio do -E opção. O executável é nomeado
do nome do arquivo .spec / .def, se presente, ou explicitamente por meio do -F opção. O
o arquivo resultante deve ser montado e vinculado a outros arquivos de objeto para construir um
executável do Wine em funcionamento, e todos os outros arquivos de objeto devem ser listados como entrada
arquivos.

--def Crie um arquivo .def a partir de um arquivo de especificação. O arquivo .spec é especificado por meio do -E opção.
Isso é usado ao construir DLLs com um compilador PE (Win32).

--implib
Construir uma biblioteca de importação PE a partir de um arquivo de especificações. O arquivo .spec é especificado por meio do -E
opção.

--Recursos
Gere um arquivo .o contendo todos os recursos de entrada. Isso é útil ao construir
com um compilador PE, uma vez que os binutils PE não podem lidar com vários arquivos de recursos como
entrada. Para uma construção Unix padrão, os arquivos de recursos são incluídos automaticamente
ao construir o arquivo de especificações, portanto, não há necessidade de um arquivo .o intermediário.

OPÇÕES

--as-cmd =como comando
Especifique o comando a ser usado para compilar arquivos de montagem; o padrão é as.

-b, --target =fabricante da CPU[-núcleo]-os
Especifique a CPU de destino e a plataforma na qual o código gerado será construído. o
a especificação de destino está no formato autoconf padrão, conforme retornado por config.sub.

--cc-cmd =comando cc
Especifique o compilador C a ser usado para compilar arquivos de montagem; o padrão é ao invés
use o montador especificado com --as-cmd.

-d, --delay-lib =nome
Defina o modo de importação atrasado para a biblioteca especificada, que deve ser um dos
bibliotecas importadas com o -l opção. O modo atrasado significa que a biblioteca não será
carregado até que uma função importada dele seja realmente chamada.

-D símbolo
Ignorado para compatibilidade com o compilador C.

-e --entry =função
Especifique a função de ponto de entrada do módulo; se não for especificado, o padrão é DllMain
para dlls e principal para executáveis ​​(se o padrão C principal não está definido, Winmain
é usado em seu lugar). Isso é válido apenas para módulos Win32.

- Ah, --export =nome do arquivo
Especifique um arquivo .spec (consulte SPEC ARQUIVO SINTAXE para obter detalhes), ou um Windows .def padrão
arquivo que define as exportações da DLL ou executável que está sendo construído.

--símbolos-externos
Permitir vinculação a símbolos externos diretamente do arquivo de especificações. Normalmente símbolos
exportado por uma dll deve ser definido na própria dll; esta opção torna
possível usar símbolos definidos em outra biblioteca Unix (para símbolos definidos em
outra dll, a para a frente especificação deve ser usada em seu lugar).

-f opção
Especifique uma opção de geração de código. Atualmente -fPIC e -fasynchronous -wind-tables
são suportados. Outras opções são ignoradas para compatibilidade com o compilador C.

--falso-módulo
Crie um módulo PE falso para uma dll ou exe, em vez do conjunto normal ou objeto
Arquivo. O módulo PE contém os recursos para o módulo, mas nenhum código executável.

-F, --filename =nome do arquivo
Defina o nome do arquivo do módulo. O padrão é usar o nome base da especificação
arquivo (sem qualquer extensão).

-h, --Socorro
Exibir uma mensagem de uso e sair.

-H, --heap =tamanho
Especifique o tamanho do heap local do módulo em bytes (válido apenas para módulos Win16);
o padrão é nenhum heap local.

-I anuário
Ignorado para compatibilidade com o compilador C.

-k, --matar-em
Remova as decorações stdcall dos nomes dos símbolos no arquivo .def gerado.
Somente significativo em --def modo.

-K bandeiras
Ignorado para compatibilidade com o compilador C.

--consciente de grandes endereços
Defina um sinalizador no executável para notificar o carregador de que este aplicativo oferece suporte
endereços de espaços maiores que 2 gigabytes.

--ld-cmd =comando ld
Especifique o comando a ser usado para vincular os arquivos de objeto; o padrão é ld.

-EU, --library-path =anuário
Acrescenta o diretório especificado à lista de diretórios que são pesquisados
bibliotecas de importação.

-eu, --library =nome
Importe a biblioteca especificada, procurando um correspondente nomedalib.def arquivo no
diretórios especificados com o -L opção.

-m16, -m32, -m64
Gere códigos de 16, 32 ou 64 bits, respectivamente.

-Marm, -mpolegar, -march =opção, -mcpu =opção
Defina as opções de geração de código para o montador.

-M, --main-module =módulo
Ao construir uma DLL de 16 bits, defina o nome de sua contraparte de 32 bits como módulo. Este
é usado para garantir que a ordem de carregamento da dll de 16 bits corresponda à do
Um de 32 bits.

-N, --dll-name =nomedadll
Defina o nome interno do módulo. Ele é usado apenas em módulos Win16. O padrão
é usar o nome base do arquivo de especificação (sem qualquer extensão). Isso é usado para
KERNEL, pois mora em KRNL386.EXE. Não deveria ser necessário de outra forma.

--nm-cmd =comando nm
Especifique o comando a ser usado para obter a lista de símbolos indefinidos; o padrão é nm.

--nxcompat =sim|não
Especifique se o módulo é compatível com suporte no-exec. O padrão é sim.

-ó, --output =lima
Defina o nome do arquivo de saída (o padrão é a saída padrão). Se o arquivo de saída
nome termina em .o, a saída de texto é enviada para um arquivo temporário que é então montado
para produzir o arquivo .o especificado.

-r, --res =rsrc.res
Carregue recursos do arquivo de recurso binário especificado. o rsrc.res arquivo pode ser
produzido a partir de um arquivo de recurso de origem com wrc(1) (ou com um recurso do Windows
compilador).
Esta opção só é necessária para arquivos de recursos Win16, os Win32 podem simplesmente
listado como entrada arquivos e será automaticamente tratado corretamente (embora o -r
opção também funcionará para arquivos Win32).

--save-tempos
Não exclua os vários arquivos temporários que construção de vinho gera.

--subsystem =subsistema[:principal[.menor]]
Defina o subsistema do executável, que pode ser um dos seguintes:
consolá para um executável de linha de comando,
Windows para um executável gráfico,
nativo para uma dll de modo nativo,
estremecer para um ce dll.
O ponto de entrada de um executável de linha de comando é um C normal principal função. UMA wmain
pode ser usada em vez disso, se você precisar que a matriz de argumento use strings Unicode.
Um executável gráfico tem um Winmain ponto de entrada.
Opcionalmente, uma versão principal e uma versão secundária do subsistema também podem ser especificadas; o padrão
a versão do subsistema é 4.0.

-você, --undefined =símbolo
Adicionar símbolo à lista de símbolos indefinidos ao invocar o vinculador. Isso faz com que seja
possível forçar um módulo específico de uma biblioteca estática a ser incluído quando
resolução de importações.

-dentro, --verbose
Exibir os vários subcomandos sendo invocados por construção de vinho.

--versão
Exiba a versão do programa e saia.

-C, - advertências
Ative os avisos.

SPEC ARQUIVO SINTAXE

Geral sintaxe
Um arquivo de especificação deve conter uma lista de declarações ordinais. A sintaxe geral é a
A seguir:

ordinal tipo de função [bandeiras] nome de exportação ( [args ...] ) [treinador]
ordinal variável [bandeiras] nome de exportação ( [dados...] )
ordinal externo [bandeiras] nome de exportação [nome do símbolo]
ordinal toco [bandeiras] nome de exportação [ (args ...) ]
ordinal igualar [bandeiras] nome de exportação dados,
# comentários

As declarações devem caber em uma única linha, exceto se o fim da linha for escapado usando um
caractere barra invertida. o # caractere em qualquer lugar em uma linha faz com que o resto da linha seja
ignorado como um comentário.

ordinal especifica o número ordinal correspondente ao ponto de entrada, ou '@' para
alocação ordinal automática (somente Win32).

bandeiras é uma série de sinalizadores opcionais, precedidos por um caractere '-'. Os sinalizadores suportados são:

-norelay
O ponto de entrada não é exibido nos rastreamentos de depuração de retransmissão (somente Win32).

-sem nome
O ponto de entrada será exportado por ordinal em vez de por nome. O nome é
ainda disponível para importação.

-ret16 A função retorna um valor de 16 bits (somente Win16).

-ret64 A função retorna um valor de 64 bits (somente Win32).

-register
A função usa o registro da CPU para passar argumentos.

-privado
A função não pode ser importada de outras dlls, só pode ser acessada
por meio de GetProcAddress.

-ordinal
O ponto de entrada será importado por ordinal em vez de por nome. O nome é
ainda exportado.

-arch =cpu[,cpu]
O ponto de entrada está disponível apenas na (s) arquitetura (s) de CPU especificada (s). o
nomes win32 e win64 corresponder a todas as arquiteturas de CPU de 32 ou 64 bits
respectivamente. Em dlls de 16 bits, especificando -arch = win32 faz com que o ponto de entrada
a ser exportado do módulo wrapper de 32 bits.

função ordinais
Sintaxe:
ordinal tipo de função [bandeiras] nome de exportação ( [args ...] ) [treinador]

Esta declaração define um ponto de entrada de função. O protótipo definido por
nome de exportação ( [args ...] ) especifica o nome disponível para link dinâmico e o formato
dos argumentos. '@' pode ser usado em vez de nome de exportação para exportações apenas ordinais.

tipo de função deve ser um dos seguintes:

stdcall
para uma função Win32 normal

pascal para uma função Win16 normal

cdecl para uma função Win16 ou Win32 usando a convenção de chamada C

Varargs
para uma função Win16 ou Win32 usando a convenção de chamada C com uma variável
número de argumentos

esta ligação
para uma função Win32 usando o esta ligação convenção de chamada (primeiro parâmetro
no registro% ecx em i386)

args deve ser um ou vários de:

palavra (Valor sem sinal de 16 bits)

espada (Palavra com sinal de 16 bits)

longo (valor inteiro de tamanho de ponteiro)

int64 (Valor inteiro de 64 bits)

int128 (Valor inteiro de 128 bits)

flutuar (Valor de ponto flutuante de 32 bits)

duplo (Valor de ponto flutuante de 64 bits)

ptr (ponteiro linear)

str (ponteiro linear para uma string ASCII terminada em nulo)

wstr (ponteiro linear para uma string Unicode terminada em nulo)

segptr (ponteiro segmentado)

segstr (ponteiro segmentado para uma string ASCII terminada em nulo).

Nota: Os tipos de ponteiro de 16 bits e segmentado são válidos apenas para funções Win16.

treinador é o nome da função C real que irá implementar esse ponto de entrada em
Modo de 32 bits. O manipulador também pode ser especificado como nomedadll.função para definir um encaminhado
função (aquela cuja implementação está em outra dll). Se treinador não é especificado, é
assumido ser idêntico a nome de exportação.

Este primeiro exemplo define um ponto de entrada para a chamada GetFocus () de 32 bits:

@ stdcall GetFocus () GetFocus

Este segundo exemplo define um ponto de entrada para a chamada CreateWindow () de 16 bits (o ordinal
100 é apenas um exemplo); também mostra como as linhas longas podem ser divididas usando uma barra invertida:

100 pascal CreateWindow (ptr ptr long s_word s_word s_word \
s_word palavra palavra palavra ptr) WIN_CreateWindow

Para declarar uma função usando um número variável de argumentos, especifique a função como
Varargs e declará-lo no arquivo C com um parâmetro '...' para uma função Win32, ou com
um argumento VA_LIST16 extra para uma função Win16. Veja as funções wsprintf * em
user.exe.spec e user32.spec para um exemplo.

Variável ordinais
Sintaxe:
ordinal variável [bandeiras] nome de exportação ( [dados...] )

Esta declaração define o armazenamento de dados como palavras de 32 bits no ordinal especificado.
nome de exportação será o nome disponível para link dinâmico. dados, pode ser um número decimal
ou um número hexadecimal precedido por "0x". O exemplo a seguir define a variável VariableA em
ordinal 2 e contendo 4 ints:

2 variáveis ​​Variável A (-1 0xff 0 0)

Esta declaração só funciona em arquivos de especificação Win16. No Win32 você deve usar externo em vez disso
(ver abaixo).

Externo ordinais
Sintaxe:
ordinal externo [bandeiras] nome de exportação [nome do símbolo]

Esta declaração define uma entrada que simplesmente mapeia para um símbolo C (variável ou função).
Ele só funciona em arquivos de especificação Win32. nome de exportação irá apontar para o símbolo nome do símbolo que
deve ser definido no código C. Alternativamente, pode ser no formato nomedadll.nome do símbolo para
definir um símbolo encaminhado (aquele cuja implementação está em outra dll). Se nome do símbolo is
não especificado, presume-se que seja idêntico a nome de exportação.

Stub ordinais
Sintaxe:
ordinal toco [bandeiras] nome de exportação [ (args ...) ]

Esta declaração define uma função stub. Ele disponibiliza o nome e o ordinal para
vinculação dinâmica, mas encerrará a execução com uma mensagem de erro se a função for
já ligou.

Igualar ordinais
Sintaxe:
ordinal igualar [bandeiras] nome de exportação dados,

Esta declaração define um ordinal como um valor absoluto. nome de exportação será o nome
disponível para link dinâmico. dados, pode ser um número decimal ou hexadecimal precedido por
"0x".

AUTORES

construção de vinho tem sido trabalhado por muitas pessoas ao longo dos anos. Os principais autores são Robert J.
Amstadt, Alexandre Julliard, Martin von Loewis, Ulrich Weigand e Eric Youngdale. Muitos
outras pessoas contribuíram com novos recursos e correções de bugs. Para uma lista completa, veja o git
confirmar logs.

Use o desenvolvimento winebuild online usando os serviços onworks.net