flshm

FLSHM

Flash Player LocalConnection Memória compartilhada Biblioteca de códigos nativos

Visão geral

Esta biblioteca é uma biblioteca de código nativa para se conectar à API LocalConnection usada pelo Flash Player. Isso é feito conectando -se à mesma memória compartilhada e semáforos, para ler e escrever no sistema de mensagens. Tudo isso foi possível pela engenharia reversa dos formatos de APIs e mensagens usados ​​pelo Flash Player.

Compatibilidade

A biblioteca foi testada contra o Flash Player 6 ou mais (o Flash Player 6 introduziu o LocalConnection) e o Flash Player no Windows, Mac e Linux são suportados.

Esta biblioteca é testada contra os compiladores Clang, GCC, MSVC e Mingw. Consulte a configuração Travis e AppVeyor CI para versões exatas que são testadas. A biblioteca provavelmente também funcionará com outros compiladores C99 compatíveis.

Uso

Consulte o diretório util para obter algum uso de amostra. Algumas coisas a ter em mente.

• As propriedades de mensagem e conexão variam de acordo com diferentes versões, consulte os comentários do cabeçalho para obter detalhes.
• data da mensagem são uma série de dados codificados da AMF, AMF0 ou AMF3, dependendo da mensagem ( size define o tamanho dos dados codificados).
• Os codificadores e decodificadores completos da AMF não estão incluídos, a biblioteca lida apenas com o subconjunto de AMF0 necessário para analisar os cabeçalhos da mensagem.
• Os argumentos da AMF0 são codificados em ordem inversa, no entanto, os argumentos do AMF3 não são.
• Alguns tipos de dados, como uma sequência AMF0, são triviais para codificar e decodificar, e essa biblioteca inclui alguns codificadores e decodificadores AMF0, mas se for necessário suporte completo de AMF0 ou AMF3, considere algumas bibliotecas AMF existentes.
• Há um máximo de 8 conexões impostas pelo Flash Player.
• Os nomes de conexão devem estar em um dos seguintes formatos, caso contrário, é inválido.
  • hostname:connection-name ( example.com:name , localhost:name )
  • _global-connection-name ( _domainshared:name )
• Os nomes de conexão não incluem o subdomínio mais baixo.
  • example.com = example.com
  • www.example.com = example.com
  • abexample.com = b.example.com ).
• Definir is_per_user para corresponder à propriedade isPerUser usada no ActionScript (o padrão é e provavelmente permanecerá false , e essa propriedade não está disponível em versões mais antigas do próprio flash player).
• O sandboxing não é implementado na própria biblioteca; portanto, valide a mensagem antes de manipulá -la.
• Limpe uma mensagem quando recebida e destinada à conexão, caso contrário, ele terá tempo limite e a conexão será removida da lista registrada.
• Use as funções flshm_lock e flshm_unlock para bloquear o semáforo para obter acesso exclusivo à memória compartilhada ao ler e escrever mensagens e conexões para evitar problemas com as condições de corrida.
• Use o flshm_close para a memória livre alocada pela biblioteca e evite vazamentos de memória.

Bugs

Se você encontrar um bug ou tiver problemas de compatibilidade, abra um ingresso na seção de problemas para este repositório.

As solicitações de tração também são bem-vindas, mas quaisquer alterações devem ser fundidas cruzadas para serem mescladas.

Licença

Copyright (c) 2016-2019 Alexander O'Mara

Licenciado sob a licença pública de Mozilla, v. 2.0.

Se esta licença não funcionar para você, não hesite em entrar em contato comigo.

Doações

Se você achar meu software útil, considere oferecer suporte ao desenvolvimento de software independente e de código aberto, fazendo uma doação modesta no meu site em Alexomara.com.